Skip to content

Document nspawn 2.0.0 - #58

Merged
Edu4rdSHL merged 1 commit into
mainfrom
docs-2.0.0
Oct 21, 2026
Merged

Edu4rdSHL merged 1 commit into
mainfrom
docs-2.0.0

Conversation

@Edu4rdSHL

Copy link
Copy Markdown
Member
  • compose.md (new): nspawn compose, a project as an example with its real output, how services become machines, networks, volumes and secrets, depends_on, builds and the names of built images, the commands, and a pointer to docs/COMPOSE.md for every attribute.
  • docker-api.md (new): the Docker API a machine gets when it mounts docker's socket (what it serves, the one write it takes, who can connect, one socket per machine, its limits), caddy-docker-proxy as the example, and auto-update with its rollback, skips and timer.
  • building.md: Dockerfile builds with nspawn's builder (what it reads, the context and its ignore file, the sandbox, the cache, the flags, the differences from docker build); mkosi runs in the service, with the output and workspace directories it is given.
  • machines.md: s6-overlay images as PID 1 and --init, GPUs and CDI devices, ps --filter/--format, inspect -f, wait and port, exec as the machine's user, kill and restart policies, healthcheck keys of inspect, --dns-search in booted machines, an events example taken from a 2.0.0 run.
  • networking.md: --ip, network connect and disconnect, docker's sysctls in an app's namespace, the namespace path before systemd 259; the examples create front before back, give postgres its password and publish nginx's port behind gluetun.
  • images.md, overview.md, getting-started.md, faq.md, configuration.md, _index.md: the lookup order of local images, machine name rules, the hub images' root password, the root mounted at start, system prune and the build cache, the units that run between commands, what --config reaches, Linux 6.5 for overlay.
  • reference.md: every new command and flag, value names as --help prints them, network create without -l, --ip without none, the hidden commands, what daemon --install writes, the completion targets.
  • contribution-guidelines.md moves after the FAQ in the menu; hugo.yaml: documented version 2.0.0.

- new pages: Compose (nspawn compose and how a project becomes
  machines) and The Docker API (the socket for proxies and dashboards,
  auto-update)
- building: Dockerfile builds, the build cache and the differences
  from docker build; mkosi runs in the service, with its output and
  workspace directories as the service names them
- machines: s6-overlay images as PID 1, --init, GPUs and CDI devices,
  the docker scripting flags of ps and inspect, wait and port, exec as
  the machine's user, kill and restart policies, healthcheck keys, an
  events example taken from a 2.0.0 run
- networking: --ip, network connect and disconnect, docker's sysctls
  in an app's namespace, --dns-search in booted machines; examples
  that create front before back and give postgres its password
- images, overview, getting started, FAQ, configuration: the lookup
  order of local images, machine name rules, the hub's root password,
  the root mounted at start, system prune and the build cache, the
  units that run between commands, what --config reaches
- reference: every new command and flag, value names as --help has
  them, network create without -l, --ip without none, the hidden
  commands and what daemon --install writes
- Contributing moves after the FAQ in the menu
@Edu4rdSHL Edu4rdSHL self-assigned this Oct 21, 2026
@Edu4rdSHL
Edu4rdSHL merged commit 38ccde3 into main Oct 21, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant