--- title: Port to Solnix natively; LX-branded zones are not built yet area: zones impact: HIGH tags: [zones, lx, brands, linux-binaries, smartos, roadmap] verified: 2026-11-04 --- # Port to Solnix natively; LX-branded zones are not built yet An LX-branded zone runs unmodified Linux binaries on the illumos kernel by translating Linux system calls. Solnix does not have one today. If you tell a user to "run the Linux build in an LX zone" on Solnix, the advice fails. Build the software for `x86_64-solaris` instead. **Antipattern** ```sh # Linux habit: copy the Linux binary over and run it, or follow zonecfg(8) Example 2 scp linux-host:/usr/local/bin/tool . && ./tool pfexec zonecfg -z lxzone "create -t SUNWlx; set zonepath=/export/zones/lxzone" ``` **The Solnix way** ```sh # Is there an illumos build already? Search the Solnix set, then use the package: # https://search.solnix.io nix profile install nixpkgs# # nixpkgs# resolves to Solnix's package set # Not packaged: port it as a pkgs.solnix.* derivation for x86_64-solaris. ls /usr/lib/brand # the brands this generation has; per the roadmap, no lx (see Unverified) ``` LX on Solnix is a roadmap item, "not built yet, and here is why we want it" (handbook: LX zones, Honest status). The plan is to bring in the SmartOS LX brand and then add a Nix-described LX zone. In the OS repo this is spec T3.6, LX-1 to LX-5, sized at several quarters. The roadmap says the LX brand is not in Solnix's pinned gate ("sn1/solaris10 only"). **The illumos way** (OpenIndiana, OmniOS, SmartOS) ```sh # SmartOS is the reference LX implementation (handbook: LX zones). The illumos zonecfg(8) man page's # Example 2 configures a non-native zone from a template; whether a given distribution ships the template is not # covered by these sources: zonecfg -z lxzone "create -t SUNWlx; set zonepath=/export/zones/lxzone; set autoboot=true" ``` A zone's brand is set when the zone is configured and cannot be changed once it is installed (zonecfg(8), zones(7)). SmartOS manages zones and VMs with its own JSON-driven `vmadm`/`imgadm` tools. **The difference.** On SmartOS, a Linux-only binary can run in an LX zone. On Solnix today, there is no LX brand. The spec expects a Linux binary in a native Solnix zone to be refused with SIGSYS (spec T3.6, LX-4 negative control). When the LX brand exists, use it for software with no illumos build. Until then, and for anything that can be ported, a native `pkgs.solnix.*` build is the route. The spec also prefers LX to a full Linux VM under bhyve. **Check.** `ls /usr/lib/brand` shows whether there is an `lx` entry (the roadmap says there is none), and `zoneadm list -cv` shows no zone with brand `lx`. When an `lx` entry appears, check the handbook's LX status again before you rely on it. **Unverified** - Whether OpenIndiana, OmniOS or SmartOS ship the `SUNWlx` template: the only source is zonecfg(8) Example 2. - Where the LX brand lives. illumos-domain.md and package-universe.md say "in-gate (from Joyent)", the spec tasks.md says "in-gate" in one place, and handbook introduction.md lists LX among what illumos-gate ships; the roadmap and spec T3.6 say Solnix's pinned gate has only the sn1/solaris10 brands. This rule follows the roadmap and T3.6, which are about Solnix's own gate. - No `lx(7)` brand man page is in the shipped man set, so LX-specific `zonecfg` properties are not covered here. **Sources** - [.kiro/steering/illumos-domain.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/illumos-domain.md) (solnix 5a8e5ce), "in-gate (from Joyent)"; and [Handbook: introduction](https://solnix.io/docs/handbook/introduction) (site 307b67f) - [brands(7)](https://solnix.io/docs/man/brands.7) (illumos, CDDL), DESCRIPTION - [zones(7)](https://solnix.io/docs/man/zones.7) (illumos, CDDL), DESCRIPTION (brand changes need an uninstall) - [zonecfg(8)](https://solnix.io/docs/man/zonecfg.8) (illumos, CDDL), DESCRIPTION ("Once a zone has been installed the brand cannot be changed"); Example 2 Creating a Non-Native Zone - [Handbook: LX-branded zones](https://solnix.io/docs/handbook/lx-zones#honest-status) (site 307b67f), What an LX-branded zone is, The Solnix plan (roadmap), Why it matters, Honest status - [Handbook: Zones](https://solnix.io/docs/handbook/zones#branded-zones) (site 307b67f), Branded zones - [Handbook: Learning Nix](https://solnix.io/docs/handbook/learning-nix#pkg--nix-command-by-command) (site 307b67f), `pkg` → Nix, command by command - [docs/roadmap.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/roadmap.md) (solnix 5a8e5ce), LX-branded zones: run Linux binaries unchanged - [.kiro/specs/solnix-phase3-breadth/tasks.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/specs/solnix-phase3-breadth/tasks.md) (solnix 5a8e5ce), T3.6 LX-1 to LX-5 - [docs/package-universe.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/package-universe.md) (solnix 5a8e5ce), SmartOS / illumos-joyent (vmadm / imgadm) - [modules/system/activation/default.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/system/activation/default.nix) (solnix 5a8e5ce), option `system.zoneBrands` (libbrand reads only /usr/lib/brand) - [modules/config/nix-channel.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/config/nix-channel.nix) (solnix 5a8e5ce), `nix.registry.nixpkgs.to` - [.kiro/steering/nix-conventions.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/nix-conventions.md) (solnix 5a8e5ce), Platform tuples, Package namespace