nami alpha Docs

Add-ons

Add Docker, Tailscale, the NVIDIA driver, another kernel and other extras to a namiOS computer.

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-onWhat it’s for
tailscale, tailscale-routerA private network with your other devices; the router also forwards for an exit node or subnet
docker, podmanContainers, with or without a background service
vscode, claude-desktopVisual Studio Code and Anthropic’s Claude app, built from their makers’ downloads
nvidia, nvidia-legacyNVIDIA graphics cards, from GTX 16xx on, or older ones from GTX 750
steam, gamemodeSteam with 32-bit graphics and game controllers, and a speed mode for games
kernel-zen, kernel-xanmod, kernel-xanmod-latestAnother kernel
printing-extra, input-cjk, speechDrivers 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:

laptop/computer.nami
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:

packages/nvme-fix/package.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.

Something wrong or missing here? nami report tells us, or Report a problem in the nami window.