For apps, your files, the daemon and builds, which work the same on any distribution, see nami’s Troubleshooting.
Check the computer
nami doctor checks the store and the graphics drivers. On namiOS it also checks that what each package sets up works.
nami doctor # what's wrong, and what to run
nami doctor --about # the hardware, for a report
Fix a USB drive that won’t write
| What you see | What to do |
|---|---|
/dev/sda isn't a USB drive or a removable disk | nami never writes a computer’s own disk. nami usb --list shows the drives it can use. |
/dev/sdb is in use (/dev/sdb1 mounted) | Eject it in Files and leave it plugged in. |
/dev/sdb is a partition | Give the whole drive: /dev/sdb, not /dev/sdb1. |
/dev/sdb holds 7.8 GB; the image needs 8.5 GB | Use a drive of 16 GB or more. |
writing ... erases it: run in a terminal to say yes, or pass --yes | Run it in a terminal, or add --yes. |
no password, and no terminal to ask for one | Run it in a terminal, or use --password-stdin. |
Fix an install that won’t start
| What you see | What to do |
|---|---|
start the computer from the USB drive first | nami install-to only runs on a computer started from a drive nami usb made. |
Windows is hibernated, or has Fast Startup on | Start Windows and shut it down fully: hold Shift while you click Shut down. |
Windows' EFI partition ... is full | namiOS’s boot menu needs 2 MB there. Free some space, or install on another disk. |
Windows is on it the old way (an MBR disk, started by BIOS) | namiOS installs next to Windows only on GPT disks. Use another disk, or --whole-disk. |
Start when a new version doesn’t
If a new version fails to start three times, the computer starts the one before it by itself. To choose a version yourself, hold Space as the computer starts and pick one from the boot menu. See Updates and going back.
Fix updates that stopped
When daily updates stop, the update’s log says why:
journalctl -u nami-update
A set from a git repo that isn’t pinned yet holds the daily update. Pin it, then apply:
sudo nami layers --update
sudo nami apply
Find a log
| What | Where |
|---|---|
| Daily updates | journalctl -u nami-update |
| Your first login | journalctl --user -u nami-first-login |
| The computer’s services | journalctl -u <name> |
| Your own services | journalctl --user -u <name> |
Tell us
nami report
It shows everything it will send before asking to send it. In Settings, it’s Report a Problem.