--- title: Run native zones with the gate's tools, and do not expect an IPS zone install area: zones impact: MEDIUM tags: [zones, zonecfg, zoneadm, zlogin, vnic, exclusive-ip, brands] verified: 2026-11-04 --- # Run native zones with the gate's tools, and do not expect an IPS zone install You configure native zones with `zonecfg`, install and run them with `zoneadm`, and enter them with `zlogin`, the same as on illumos. The install step is different. On OpenIndiana, `zoneadm install` fills the zone from IPS. Solnix has no IPS and does not ship the IPS-based ipkg install hook, so a recipe copied from OpenIndiana cannot install a zone the OpenIndiana way. **Antipattern** ```sh # OpenIndiana habit: install fills the zone from IPS publishers, then pkg inside the zone pfexec zoneadm -z web install pfexec zlogin web pkg install video/ffmpeg ``` **The Solnix way** ```sh # No solnix.zones.* module yet (handbook: Zones). The gate's tools are present: zoneadm list -cv # every configured zone: state, root, brand, ip-type pfexec zonecfg -z web info # a zone's stored configuration pfexec zoneadm -z boot # for an installed zone; also: halt, shutdown, reboot pfexec zlogin # a shell in the zone (superuser in the global zone only) # The zone the OS repo builds is the community builder's, declared, not hand-made # (modules/config/community/builder-zone.nix). It is on when queue building is on (solnix.privacy.enable = false, # solnix.cache.build.enable, default true) and solnix.builder.isolation = "zone"; its assertions also need # solnix.builder.shortId, solnix.firewall.enable and a non-empty solnix.cache.build.zone.uplinks, and # solnix.cache.build.zone.dataset has no default (set it, e.g. "data/zones/solnix-builder"). ``` That zone uses a `solnix` brand, registered through `system.zoneBrands`. The brand's install hook copies the global zone's /usr, /lib, /sbin and /bin link farms into `/root` (cpio, as links), copies the closure of world, early and sw plus the zone's own scripts into the zone's `/nix/store` (nix copy), and takes /etc and /var from the gate's stock tree; nothing comes from IPS. The hook is written around the builder (its user, nixbld users and nix.conf); whether it can install other zones is not documented. Its zonepath is a ZFS dataset "Not under a BE root". **The illumos way** (OpenIndiana, OmniOS, SmartOS) ```sh pfexec dladm create-vnic -l e1000g0 vnic0 # a dedicated VNIC for the zone pfexec zonecfg -z web "create; set zonepath=/zones/web; set ip-type=exclusive; add net; set physical=vnic0; end; set autoboot=true; verify; commit" pfexec zoneadm -z web install # OpenIndiana: a pkg image + minimal packages under zonepath/root pfexec zoneadm -z web boot pfexec zlogin web ipadm create-if vnic0 # exclusive-IP: the zone configures its own address pfexec zlogin web ipadm create-addr -T dhcp vnic0/dhcp ``` On OpenIndiana, ipkg zones are IPS images (`pkg update -r` updates them with the global zone), and the zonepath's parent must be a ZFS dataset. `autoboot` has no effect unless `svc:/system/zones:default` is enabled. **The difference.** The zone framework and its commands come from the gate (handbook: Zones, "inherited from the illumos gate"); what differs is the install step. The commands above that set up the VNIC and the exclusive-IP network come from the gate too. OpenIndiana installs zones with IPS. Solnix has no IPS, and the ipkg brand's install hook comes from IPS, which Solnix does not ship (the `solnix` brand's config.xml says so). A declarative `solnix.zones.*` module, the Solnix analog of a NixOS container, is not built yet (handbook: Zones, Solnix relevance). **Check.** `zoneadm list -cv` lists the global zone and each zone with its state. A zone is `configured` before install, `incomplete` if an install or uninstall was interrupted, `installed` after one, and `running` after `boot`. **Unverified** - Whether the gate's ipkg brand directory exists under `/usr/lib/brand` on Solnix, and what `zoneadm install` does for a default-brand zone there. The sources say only that IPS ships the ipkg install hook and that Solnix has none. **Sources** - [zonecfg(8)](https://solnix.io/docs/man/zonecfg.8) (illumos, CDDL), PROPERTIES global: zonepath, autoboot, brand, ip-type; net: physical, allowed-address; SUBCOMMANDS create, commit, verify, info; Example 3 Creating an Exclusive-IP Zone - [zoneadm(8)](https://solnix.io/docs/man/zoneadm.8) (illumos, CDDL), SUBCOMMANDS boot, halt, install, list -c -v, shutdown - [zlogin(1)](https://solnix.io/docs/man/zlogin.1) (illumos, CDDL), DESCRIPTION, SYNOPSIS - [zones(7)](https://solnix.io/docs/man/zones.7) (illumos, CDDL), zone states - [ipadm(8)](https://solnix.io/docs/man/ipadm.8) (illumos, CDDL), create-if; create-addr -T dhcp - [dladm(8)](https://solnix.io/docs/man/dladm.8) (illumos, CDDL), create-vnic - [Handbook: Zones](https://solnix.io/docs/handbook/zones#solnix-relevance) (site 307b67f), status note, Brief usage (on any illumos host), Solnix relevance - [modules/config/community/options.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/config/community/options.nix) (solnix 5a8e5ce), `privacy.enable`, `cache.build.enable`, `active.build` - [modules/config/community/builder-zone.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/config/community/builder-zone.nix) (solnix 5a8e5ce), header comment, zonecfg command file, option `dataset` - [modules/config/community/zone-install.sh](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/config/community/zone-install.sh) (solnix 5a8e5ce), header comment - [modules/config/community/zone-brand/config.xml.in](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/config/community/zone-brand/config.xml.in) (solnix 5a8e5ce), header comment ("IPS ships ipkg's, solnix has none") - [modules/system/activation/default.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/system/activation/default.nix) (solnix 5a8e5ce), option `system.zoneBrands` - [.kiro/steering/product.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/product.md) (solnix 5a8e5ce), "No IPS/pkg in the end product" - [OpenIndiana handbook: System Administration](https://docs.openindiana.org/handbook/systems-administration/#zones) (PDL), Zones, Zone networking model, Quick Setup Example, Fixing zone installation issues