--- name: solnix-is-not-upstream-illumos description: The places Solnix differs from OpenIndiana, OmniOS and SmartOS, and how to explain each. Always on when giving illumos advice to a Solnix user. --- # Solnix is not upstream illumos Solnix is illumos (the kernel, libc, SMF, ZFS, zones and DTrace come from the illumos gate), but the system is built, configured and upgraded with Nix and the NixOS module system. Upstream illumos advice (OpenIndiana, OmniOS, SmartOS docs, blog posts, your training data) is right about the illumos parts and wrong about the parts Nix replaced: | upstream illumos | Solnix | |---|---| | `pkg install` / `pkg update` (IPS: OpenIndiana, OmniOS; SmartOS uses pkgsrc) | no IPS in the finished system; `nix profile install`, or `environment.systemPackages` plus `solnix-rebuild switch` | | a BE per `pkg update` (OpenIndiana, OmniOS) | a BE per generation, named `solnix-N`; `solnix-rebuild rollback` | | hand-written SMF manifest + `svccfg import` | `smf.services.` in the system config; activation imports the generated manifest | | `useradd`, `/etc/passwd` edits | `users.users.`; the next boot environment gets the generated /etc/passwd, shadow, group lines (`passwd` still sets passwords) | | `crle` | RUNPATH baked to /nix/store paths at link time | | `zoneadm install` from IPS (ipkg) | no IPS and no ipkg install hook; extra brands come from `system.zoneBrands` (the community builder's `solnix` brand is one) | | LX zones (SmartOS, OmniOS) | not built yet on Solnix (roadmap) | | `/usr/gnu/bin` GNU tools (OpenIndiana) | GNU tools are Nix packages (`pkgs.solnix.gnugrep`), not on a bare system | | `sudo` with a sudoers file (OpenIndiana) | `sudo` is a wrapper over `pfexec` and RBAC profiles | Always give the Solnix way first, then the illumos way, then say why they differ. Say "same as illumos" when they are the same, and only where a rule in `solnix/rules/` says so (the rules for SMF diagnosis, the ZFS commands, FMA, DTrace on x86_64, libc and the link editor do, for example). Before you run a `solnix-rebuild` command from this table, read `confirm-destructive.md` (rollback; a switch that would re-create an existing `solnix-N`). Sources: [solnix product.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/product.md) ("No IPS/pkg in the end product", pillars 3-5); [illumos-domain.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/illumos-domain.md); [design-generations.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/design-generations.md); [modules/config/users.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/config/users.nix); [handbook: SMF](https://solnix.io/docs/handbook/smf#how-solnix-manages-services); [handbook: learning Nix](https://solnix.io/docs/handbook/learning-nix) (`pkg` to Nix, command by command); [handbook: DTrace](https://solnix.io/docs/handbook/dtrace); [illumos: Distributions](https://illumos.org/docs/about/distro/) (feature chart, LX column); [modules/system/activation/default.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/system/activation/default.nix) (`system.zoneBrands`); the rules zones-native, zones-lx, link-runpath-origin, smf-diagnose-failures, zfs-datasets-and-properties, dtrace-for-admins, shell-xpg4-vs-gnu, rbac-pfexec, users-and-updates-solnix-way.