Skip to content

Document 1.9.0 #46

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Edu4rdSHL merged 1 commit into from
Oct 1, 2026
Merged

Document 1.9.0 #46

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion content/en/docs/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,9 @@ Both are for administrators by default, so `sudo nspawn ...` works as it always
did, and a desktop session (or a terminal where you started `pkttyagent`) is
asked for a password instead. Root is never asked, which is also how the
service keeps working where polkit is not installed: there, nobody but root can
call it.
call it. One interface asks nothing: `org.nspawn.Names` hands out the names of
machines, images, networks and volumes, and nothing else about them, to any
user.

To drive nspawn without a password, an administrator hands an action to a group
in a rule of their own. The packages ship one as an example in their
Expand Down
21 changes: 18 additions & 3 deletions content/en/docs/reference.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -769,9 +769,24 @@ not a command to type; `--install` is.
nspawn completions bash|elvish|fish|powershell|zsh
```

Writes the completions for that shell on standard output; they come from the
same definition the command line itself is built from. The packages install
them, so this is for a binary you built yourself:
Writes the completions for that shell on standard output. Commands and flags
come from the same definition the command line itself is built from; besides
them, TAB completes names, asked from the service as it goes:

| After | TAB offers |
| --- | --- |
| `stop`, `exec`, `kill`, `pause`, `unpause`, `top`, `shell`, `stats` | the running machines |
| `start` | the images that do not run |
| `rm`, `inspect`, `logs`, `restart`, `update`, `images rm` | every machine and image |
| `create`, `push` | the local images |
| `run` | the references of the local images |
| `--network` | the networks, and `host`, `none` and `veth` |
| `network rm`, `network inspect` | the networks |
| `volume rm` | the volumes |

The service hands those names to any user without asking polkit, so this works
under `sudo` and without a password; secrets are not completed. The packages
install the completions, so this is for a binary you built yourself:

```shell
nspawn completions bash > ~/.local/share/bash-completion/completions/nspawn
Expand Down
2 changes: 1 addition & 1 deletion hugo.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ params:
privacy_policy: /about/#privacy

# Version of nspawn the documentation describes.
version: 1.8.0
version: 1.9.0
archived_version: false

# In-page links to open issues and suggest changes.
Expand Down