On namiOS, /etc/nami/computer.nami is the whole computer. Everything else is built from it, and each person’s own setup is in their user.nami.
Describe the computer
A small but complete computer looks like this:
hostname: laptoptimezone: Europe/Copenhagenlanguage: da_DK.UTF-8keyboard: dkpackages: - namios # namiOS's desktop and everyday apps - tailscale # an add-on - vlc # an app for everyoneusers: ada: { admin: true, name: Ada Lovelace } sam: { name: Sam }settings: org.gnome.desktop.interface: color-scheme: prefer-dark # everyone's default; each person can change theirsEvery key is in Options. Apps for everyone, services and files in /etc work as they do on any distribution: see computer.nami.
Apply a change
Edit the file, then apply it as an admin. Settings does the same when you change something under This computer.
nami check /etc/nami/computer.nami # find mistakes first
nami apply
namiOS builds the new system next to the running one and starts what’s new. A new kernel is used from the next start, and you can always go back.
Name the computer and set its region
hostname, timezone, language and keyboard are the computer’s name on the network, its time zone, its locale and its keyboard layout.
hostname: laptop
timezone: auto # follow where the computer is
language: en_US.UTF-8
keyboard: us
Left out, the name is nami and the rest are copied from the computer that made the USB drive.
Add people
users: lists who can log in, and which of them are admins.
users:
ada: { admin: true, name: Ada Lovelace }
sam: { name: Sam, groups: [docker] }
People and parental controls covers passwords, children and taking someone out.
Join Wi-Fi networks
Networks listed here are known to everyone from the first start. Write the password plainly, then seal it with nami secret seal /etc/nami/computer.nami before you commit the file.
wifi:
home: { password: !secret "correct horse battery staple" }
cafe: {} # an open network
Secrets explains sealing.
Choose the desktop
desktop: picks the desktops on the login screen, the first being the default. Leave it out for a computer with only a text console, like a server.
packages:
- namios
desktop: niri
Leave something out
without: keeps out a package or service that another package brings.
packages:
- namios
without:
- printing # a whole package folder
- nami-update.timer # no daily updates
Add an add-on
Docker, Tailscale, the NVIDIA driver and other extras are packages you copy in and list. Add-ons lists them all.
nami new laptop --from docker
That copies the add-on into packages/. Then list it:
packages: - namios - docker