--- title: Package software as a pkgs.solnix derivation plus a served recipes.tsv row area: recipe impact: HIGH tags: [recipe, nix, derivation, pkgs.solnix, recipes.tsv, cache, man, debug, smf] verified: 2026-11-04 --- # Package software as a pkgs.solnix derivation plus a served recipes.tsv row A Solnix package is a Nix derivation under `pkgs.solnix.` in the build team's repo. It must build with store tools only on PATH (many served recipes still do not: see the status note below), passes the publish gate, and reaches the cache only for an `out` path listed in the recipes.tsv that the infra team serves. A path with no served row is never published, and a user's Nix falls back to building it from source. **Antipattern** ```sh ./configure --prefix=/usr/local && gmake install # outside /nix/store: no derivation, nothing the cache can serve pfexec pkg install ... # no IPS/pkg in a finished Solnix system patchelf --set-rpath ... bin/foo # GNU patchelf does not work on illumos ELF; use elfedit/elfdump cp foo.service /etc/systemd/system/ # no systemd; systemd.services.* evaluates and is ignored # recipes.tsv: typing an `out` hash by hand, rewriting the file, or naming the path solnix-foo-1.0 ``` **The Solnix way** ```nix # spec shape from docs/design-pkgsrc-patches.md §4 (pkgs/illumos/packages.nix, built by mk-userland-pkg.nix) foo = pkg { pname = "foo"; version = "1.0"; # store path foo-1.0: no solnix-/illumos- prefix src = { url = "https://example.org/foo-1.0.tar.gz"; sha256 = "…"; }; deps = [ self.ncurses.gcc ]; patches = [ ./patches/pkgsrc/foo-illumos.patch ]; # pkgsrc patches are -p0; set patchFlags = "-p1" for git ones configureFlags = [ "--disable-static" ]; }; # a daemon ships as an SMF service in a module, never a unit file (see smf-declare-services): # smf.services.foo = { enable = true; category = "site"; start.exec = "${pkgs.solnix.foo}/bin/food &"; }; ``` ```sh nix build .#packages.x86_64-solaris.foo # packages.aarch64-solaris.foo where exported; a row per system nix-store --realise --check "$(nix-store -q --deriver result)" # a second build must give the same bytes # then scripts/publish-gate.sh on illumos: deriver resolves, store-only RUNPATH, ldd resolves inside /nix/store # then ONE appended row per output in docs/registry/recipes.tsv (tab-separated, 10 columns; # common buildsys: autotools, cargo, script, make, go, cmake, meson): # pname version url sha256 buildsys deps flags system out debug # foo 1.0 https://… autotools gcc,libc,ncurses has_manpages=y has_docs=n edition=unstable origin_distro=illumos x86_64-solaris /nix/store/-foo-1.0 ``` `out` is the path the build produced, never typed in or copied from an old row. The build team appends rows, the infra team reviews and serves the file, and every reference of `out` must already be served (or, in a batch the infra team serves at once, be in the same batch). Man pages go in `$out/share/man` (design-manpages.md: no separate `man` output; the handoffs plan one from wave6 on, with its own row); the row that holds them carries `has_manpages=y`, and the infra indexer makes them searchable at solnix.io/search. **The illumos way** (OpenIndiana, OmniOS, SmartOS) ```sh cd oi-userland/components//foo # Makefile: COMPONENT_NAME, COMPONENT_VERSION, COMPONENT_ARCHIVE_URL, gmake sample-manifest # COMPONENT_ARCHIVE_HASH; foo.p5m is the IPS manifest gmake publish # into the local repo (after a one-time gmake setup and pfexec pkg refresh # pkg set-publisher -g file://$HOME/oi-userland/i386/repo userland) pfexec pkg install pkg://userland/ # a commit to oi-userland: Jenkins builds, publishes to /hipster ``` OpenIndiana describes a package as a Makefile plus an IPS `.p5m` manifest, published to an IPS repository. **The difference.** Both record url, hash and deps, but Solnix has no `.p5m` manifest, FMRI or IPS repository: the derivation is the package, its RUNPATH holds store paths, and the cache takes only an `out` that a served row lists. A build that works on an OpenIndiana host is not enough: the store-only check rejects host tools (/usr/bin, /usr/sbin, /usr/gnu, /opt) on the build PATH. mk-userland-pkg splits DWARF into a `debug` output (CTF stays in `out`): its path goes in the out row's `debug` column and the `-debug` output gets its own row, though at 5a8e5ce that column is empty in every row. **Check.** `XDG_CACHE_HOME=$(mktemp -d) nix store verify --no-contents --store https://cache.solnix.io --trusted-public-keys 'cache.solnix.io-1:8UNrVAOSOrI9PGHc8/pD2Yqp265ZeYb3OId+gv4+wm8=' /nix/store/-foo-1.0` exits 0: the path is served and signed. Before that, the served file at `https://cache.solnix.io/registry/recipes.tsv` must list your `out`. **Unverified** - How OmniOS (omnios-extra) and SmartOS (pkgsrc) package software: not in the sources used here. - Which `pkgs/illumos/*.nix` file a new package goes in today (the sources name packages.nix and cli/*.nix), and the arguments publish-gate.sh takes: ask the build team. **Status.** Not every recipe is store-only yet: handoff rows1-b1 (2026-11-02) holds back the GTK stack and the aarch64 mk-src-pkg builds, and from-builder-20261102T193852 says most mk-src-pkg recipes and every aarch64 recipe still had host tool directories on PATH. Not every pname has a `packages.aarch64-solaris` attr (handoff 20261103T184639). **Sources** - [.kiro/steering/nix-conventions.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/nix-conventions.md) (solnix 5a8e5ce), Platform tuples; Package namespace (canonical); Debug symbols; Shared-file concurrency (append rows) - [.kiro/steering/builder-queue.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/.kiro/steering/builder-queue.md) (solnix 5a8e5ce), The contract (recipes.tsv 10 columns, `out` authority anchor, never claim a hash we did not produce, Systems); Order of work (publish gate); Man pages - [AGENTS.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/AGENTS.md) (solnix 5a8e5ce), solnix.io belongs to the infra team (no waivers on the publish gate; only what the served recipes.tsv authorizes; 8UNr check) - [docs/registry/recipes.tsv](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/registry/recipes.tsv) (solnix 5a8e5ce), header, buildsys and flags values, empty `debug` column - [docs/cache-submit-onboarding.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/cache-submit-onboarding.md) (solnix 5a8e5ce), Rules that will reject your submission; served registry/recipes.tsv; Client notes (nix store verify) - [docs/design-pkgsrc-patches.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/design-pkgsrc-patches.md) (solnix 5a8e5ce), §4 Apply (the `pkg { … }` spec, patches, patchFlags) - [docs/design-manpages.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/design-manpages.md) (solnix 5a8e5ce), Approach (--mandir=$out/share/man, man stays in $out) - [docs/man-and-debug-delivery.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/man-and-debug-delivery.md) (solnix 5a8e5ce), What provides what; debug-info.nix - [.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; pillars 3 (SMF) and 4 (RUNPATH, elfedit/elfdump) - [docs/design-solaris-stdenv.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/design-solaris-stdenv.md) (solnix 5a8e5ce), §7 proof (`nix-store -q --deriver result` resolves) - [modules/nixos-compat.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/nixos-compat.nix) (solnix 5a8e5ce), systemd.services is an ignored stub - [modules/system/boot/init/smf.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/modules/system/boot/init/smf.nix) (solnix 5a8e5ce), smf.services options - [docs/registry/DROPPED-x86_64-regen.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/registry/DROPPED-x86_64-regen.md) (solnix 5a8e5ce), do not copy an old hash back in; produce a fresh row from the current tree - [handoff: 20261015-recipe-outputs-missing-from-cache.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261015-recipe-outputs-missing-from-cache.md), an unserved path falls back to building from source; regenerate `out` from what you built - [handoff: from-builder-20261022T174500-solnix-names-nixpkgs-mapping-and-solnix-scheme.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261022T174500-solnix-names-nixpkgs-mapping-and-solnix-scheme.md), 1. `packages.x86_64-solaris` exports every pkgs.solnix derivation - [handoff: builder-steering-queue-and-work.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/builder-steering-queue-and-work.md), `out` is the expected store path - [handoff: 20261026-git-smart-http-manpages-arch-manifest.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261026-git-smart-http-manpages-arch-manifest.md), 2. Man pages: the indexer reads recipes.tsv - [handoff: 20261102-rows-served-2611-default-e1-hosted-answers.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261102-rows-served-2611-default-e1-hosted-answers.md), 8. Debug, man, doc and info outputs (row per output; `debug` column) - [handoff: from-builder-20261102T193852-reply-hosts-trusted-publishers.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261102T193852-reply-hosts-trusted-publishers.md), pre-submit gates (store-only build PATH, `--realise --check`, publish-gate) - [handoff: from-builder-20261102T194222-rows1-b1-rows/README.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261102T194222-rows1-b1-rows/README.md), Checks; What we hold back - [handoff: from-builder-20261103T184639-reply-ALERT-backlog-plan.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261103T184639-reply-ALERT-backlog-plan.md), x86-only pnames have no `packages.aarch64-solaris` attr - [handoff: from-builder-20261025T010000-main-2d78d39-recipe-rows.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261025T010000-main-2d78d39-recipe-rows.md), Evidence (`nix build .#packages.x86_64-solaris.`) - [OpenIndiana docs: Building with oi-userland](https://docs.openindiana.org/dev/userland/), Overview; Building and installing your first packages; Creating Makefile