# Solnix

> Solnix is a distribution of illumos built with the Nix package manager and the NixOS module system: declarative machines, ZFS boot environments as generations, SMF instead of systemd. A signed binary cache for x86_64-solaris and aarch64-solaris, full-text package search, man pages, and a long-form handbook are live today; a headless install image (TUI, wifi) is in dev-preview.

This file follows the llms.txt convention: a compact, factual index for language models and agents. Statuses are honest — "live" means usable today, "dev-preview" means a working artifact you can try, "planned" means designed but not built.

## Query, don't crawl — start here

Solnix is built to be QUERIED, not scraped. One MCP call returns cited passages; do not fetch hundreds of HTML pages to reconstruct what one call answers. See [agents.txt](https://solnix.io/agents.txt) and [robots.txt](https://solnix.io/robots.txt).

- MCP endpoint: `https://solnix.io/mcp` (JSON-RPC 2.0, no key). Info: `GET https://solnix.io/mcp`.
- MCP tool reference (every tool, arguments, examples): [https://solnix.io/mcp-tools](https://solnix.io/mcp-tools)
- REST API (OpenAPI): [https://solnix.io/api](https://solnix.io/api) and `GET /api/v1/openapi.json`
- GraphQL: `POST https://solnix.io/graphql` (playground at `GET /graphql`)
- Agent skills (illumos + Nix): [https://solnix.io/skills/](https://solnix.io/skills/)

## What to call for which job

- Find a package: MCP `search_packages` or `GET /api/v1/packages?q=`
- One package's metadata/deps: MCP `get_package` / `package_dependencies`, or `GET /api/v1/packages/:attr[/deps]`
- Man pages: MCP `search_manpages`, or `GET /api/v1/manpages[?q=]`, `GET /api/v1/manpages/:name[/:section]`
- Handbook content: MCP `search_handbook` / `get_handbook`, or `GET /api/v1/handbook[/search?q=]`
- Anything, across all of it: MCP `solnix_search {query, kinds}` (packages+manpages+handbook, cited)
- Supported architectures + counts: MCP `list_systems`, or `GET /api/v1/systems`
- Project knowledge (illumos/Nix/Solnix): MCP `solnix_knowledge`

## Install (binary cache)

- Cache: `https://cache.solnix.io` — signing key `cache.solnix.io-1:8UNrVAOSOrI9PGHc8/pD2Yqp265ZeYb3OId+gv4+wm8=`
- Install root (flake): `git+https://git.solnix.io/solnix.git#<pkg>` (default branch = latest edition, e.g. `26.11`; `?ref=unstable` for bleeding edge; `?rev=<sha>` to pin)
- Source git (anonymous read): `https://git.solnix.io/solnix.git`, `https://git.solnix.io/solnix-pkgs.git`

## Main pages

- [Homepage](https://solnix.io/): what Solnix is, what works today, binary-cache quick start.
- [Download / status](https://solnix.io/download): install-image status; headless TUI image is dev-preview.
- [Package search](https://search.solnix.io/): live full-text search across the cache, per architecture.
- [Docs & man pages](https://solnix.io/docs): man-page and knowledge-base browser.
- [Community pulse](https://solnix.io/pulse): opt-in aggregate usage stats (no PII).
- [Security](https://solnix.io/security): how to report a vulnerability; cache signing-key fingerprint.
- [security.txt](https://solnix.io/.well-known/security.txt): RFC 9116 security contact.

## Handbook

- [Handbook index](https://solnix.io/handbook/): canonical long-form documentation (also searchable via the API/MCP above).
- [Introduction](https://solnix.io/handbook/introduction): what Solnix is and its honesty policy.
- [Getting started](https://solnix.io/handbook/getting-started): what you can do today.
- [For Linux users](https://solnix.io/handbook/for-linux-users), [BSD](https://solnix.io/handbook/for-bsd-users), [macOS](https://solnix.io/handbook/for-macos-users), [Windows](https://solnix.io/handbook/for-windows-users): translation guides.
- [Learning Nix](https://solnix.io/handbook/learning-nix): Nix concepts for newcomers.
- [Binary cache](https://solnix.io/handbook/binary-cache): using cache.solnix.io, the signing key, seeding.
- [How Solnix is built](https://solnix.io/handbook/how-solnix-is-built): platform tuple, seed toolchain, stdenv.
- [CPU architecture support](https://solnix.io/handbook/cpu-support): x86_64 (primary) and aarch64 live; the roadmap.
- [SMF](https://solnix.io/handbook/smf), [Boot environments](https://solnix.io/handbook/boot-environments), [ZFS](https://solnix.io/handbook/zfs), [Zones](https://solnix.io/handbook/zones) / [LX zones](https://solnix.io/handbook/lx-zones), [Networking](https://solnix.io/handbook/networking), [DTrace](https://solnix.io/handbook/dtrace), [Debugging](https://solnix.io/handbook/debugging): the illumos surface.
- [Community build federation](https://solnix.io/handbook/community-build-federation): reproducibility-as-trust and the email-patch governance model.
- [P2P](https://solnix.io/handbook/p2p): peer-to-peer cache distribution over WebRTC.
- [Privacy](https://solnix.io/handbook/privacy): telemetry off by default; pulse is opt-in.
- [Contributing](https://solnix.io/handbook/contributing): repos, ways to help, mailing lists.
- [History](https://solnix.io/handbook/history): illumos lineage and how Solnix came to be.

## Community

- Mailing lists: `hackers@solnix.io` (patches, discussion) and `announce@solnix.io`. Public archive, NNTP/IMAP read access.
- Source: [git.solnix.io](https://git.solnix.io/) and the Codeberg mirror at [codeberg.org/gregburd](https://codeberg.org/gregburd).