You need a Linux computer with nami installed and a USB drive of 16 GB or more. To install namiOS as it comes, without a terminal, use the namiOS Installer instead.
Describe the computer
Start from one of nami’s examples. nami copies it into a folder named after the computer, with the package folders it uses in packages/.
mkdir -p ~/nami && cd ~/nami
nami new laptop --from namios
# laptop, from nami's namios example: namiOS, nami's own, batteries included.# `nami usb laptop --to /dev/sdX` makes a USB drive of it.hostname: laptop# A name is nixpkgs' package, set up by its folder in ../packages when# there is one (yours to change); namios, niri and the like are only there.packages: - namiosusers: ada: { admin: true }Then make it yours: the region, the apps for everyone, and the people.
…hostname: laptoptimezone: Europe/Copenhagenlanguage: da_DK.UTF-8keyboard: dk…packages: - namios - gimpusers: ada: { admin: true } ada: { admin: true, name: Ada } sam: { name: Sam }Start from namios-bare instead for only the desktop, Ghostty, Files and Firefox. A hostname, time zone, language or keyboard you leave out is copied from the computer you’re on. More about users: is in People, and every key is in Options.
Give each person their apps
Each person’s own apps and settings go in laptop/<login>/user.nami, applied at their first login.
packages: - blender - zsh: login-shell: true # sam's terminals open zshRun nami check laptop to check the computer’s file and each person’s before you build anything.
Try it in a window
nami try laptop
The computer starts in a window in a minute or two, sharing this computer’s downloads. Nothing is written to a disk. It needs /dev/kvm to be quick.
Make the USB drive
Plug in the USB drive and run:
nami usb laptop # or a config repo: nami usb github:ada/nami-config/laptop
nami asks for each person’s password, builds the system, and asks which USB drive to use. It says what will be erased and waits for you to type yes.
| Option | What it does |
|---|---|
--list | List the USB drives plugged in, and why one can’t be used |
--to /dev/sdb | Write to this drive (the whole disk, not /dev/sdb1) |
--out laptop.raw | Write the image to a file instead, for a virtual machine |
--for-anyone | Leave out the people and secrets; the first start asks who you are |
nami only writes to a USB drive or removable disk that isn’t mounted, never to a computer’s own disk. The next drive for the same computer reuses its passwords and keys from ~/.cache/nami/os.
Start a computer from it
Plug in the USB drive, turn the computer on, press the boot menu key (usually F12, F9 or Esc) and choose the drive. Secure Boot can stay on: the first time, enroll the computer’s key as described in Get namiOS.
Install it on the disk
Running from the USB drive, put the computer on its own disk, where it’s faster. People, files, Wi-Fi networks and apps all come along. In Settings, click Install on This Computer, or run:
nami install-to # list the disks
nami install-to /dev/nvme0n1 # install on this one
nami says what will be erased and waits for yes. Then it asks whether to encrypt the disk, copies the computer onto it and puts it first in the boot menu. Restart, and take out the USB drive once the computer has started from the disk.
To encrypt without being asked, add --encrypt. An encrypted disk asks for its password every time the computer starts, and there’s no way in without it, so keep it somewhere safe.
Keep Windows next to it
When Windows is on the disk, nami install-to asks whether to keep it, and how much space namiOS gets:
nami install-to /dev/nvme0n1 --next-to-windows --size 120G
nami uses free space when there’s enough; otherwise it makes C: smaller, leaving Windows what it uses and 20 GB more. Afterwards, a menu at every start lets you choose namiOS or Windows.
Shut Windows down fully first by holding Shift while you click Shut down. With BitLocker on, make the room yourself in Windows’ Disk Management, and have your recovery key at hand. To install next to Windows without a USB drive, see Install next to Windows.
Change it later
On the computer, /etc/nami/computer.nami describes the whole system. An admin changes it and applies, as on any computer with nami:
nami install --for-everyone htop
packages: - namios - htopEach change makes a new version you can go back to. See Updates and going back.