See what there is
Some things are more than an app: Docker needs a service, a group and kernel modules. Each of these is an add-on, a package folder that you copy into your config repo and list in computer.nami.
| Add-on | What it’s for |
|---|---|
tailscale, tailscale-router | A private network with your other devices; the router also forwards for an exit node or subnet |
docker, podman | Containers, with or without a background service |
vscode, claude-desktop | Visual Studio Code and Anthropic’s Claude app, built from their makers’ downloads |
nvidia, nvidia-legacy | NVIDIA graphics cards, from GTX 16xx on, or older ones from GTX 750 |
steam, gamemode | Steam with 32-bit graphics and game controllers, and a speed mode for games |
kernel-zen, kernel-xanmod, kernel-xanmod-latest | Another kernel |
printing-extra, input-cjk, speech | Drivers for older printers, typing Chinese, Japanese and Korean, and voices for the screen reader |
nami new with no arguments lists every example. VS Code and Claude Desktop are apps, so they can also go in your own user.nami.
Add one
Copy the add-on into your config repo, next to the computer’s folder:
nami new laptop --from docker # copies it into ./packages
Then list it in computer.nami and apply, or make a new USB drive:
packages: - namios - dockerusers: ada: { admin: true }The copy is yours: an ordinary package.nami you can read and change. nami never writes over a package that’s already in packages/. To take an add-on off, remove its line and apply.
In Settings, an admin’s Apps for Everyone page has the add-ons under Set Up on This Computer. Clicking one copies it, lists it and applies.
Set the computer up for a use
Eight examples are groups of apps for one use: gaming, coding, office, photos, video, making, talking and learning. You add them the same way, or from Uses on the same page.
packages:
- namios
- gaming # Steam, Heroic and more
without:
- heroic # all but this one
users:
ada: { admin: true }
Join your Tailscale network
With tailscale listed, tailscaled starts with the computer, and sudo tailscale up logs you in through the browser. To keep its settings in your repo, add a settings file:
packages:
- namios
- tailscale
users:
ada: { admin: true }
files:
/etc/tailscale/up.conf:
set: # any `tailscale set` flag
hostname: laptop
operator: ada # ada runs tailscale without sudo
ssh: true
To log in by itself on the first start, add an auth key from Tailscale’s admin console as a secret at /run/nami/secrets/tailscale-auth-key. For an exit node or subnet router, list tailscale-router instead and set advertise-exit-node: true or advertise-routes.
Run Docker
With docker listed, Docker works as it does on Ubuntu: dockerd starts with the computer, and docker compose and docker buildx work. Images and volumes are kept through updates.
packages:
- namios
- docker
users:
ada: { admin: true, groups: [docker] } # ada runs docker without sudo
files:
/etc/docker/daemon.json:
content:
log-driver: local
restarts: docker.service # restart dockerd when this changes
Anyone in the docker group can do what root can, as on Ubuntu. Rootless Docker isn’t set up; use podman for that.
Use an NVIDIA card
List nvidia for a GTX 16xx, RTX 20xx or newer, or nvidia-legacy for an older card, never both. The desktop then draws with the card, and CUDA and nvidia-smi work. nami doctor names your card and the add-on that’s for it.
The driver isn’t free software, so nami builds it from NVIDIA’s download once, which takes a few minutes. On a computer without an NVIDIA card nothing loads, so one USB drive works on both. Secure Boot stays on.
Play games with Steam
steam brings the 32-bit graphics drivers most games need and the rules for game controllers and VR headsets. Turn on Proton for Windows games in Steam’s settings, under Compatibility. With gamemode too, put gamemoderun %command% in a game’s launch options.
Use another kernel
List one kernel add-on at most. Drivers such as nvidia are built for the kernel you choose.
packages:
- namios
- kernel-zen # stays responsive under load, as Arch's linux-zen
users:
ada: { admin: true }
To go back, take the line out and apply. Until then, the boot menu still has the previous kernel: hold Space as the computer starts.
Add a kernel option
Some hardware needs an option on the kernel’s command line, such as an NVMe drive that won’t wake from sleep. Put it in a small package of your own and list it in computer.nami:
boot: kernel-options: [nvme_core.default_ps_max_latency_us=0]The keys are in boot. To write a bigger add-on, copy one and change it, or start from Your own packages.