nami alpha Docs

Troubleshooting

Fix problems that only happen on namiOS: making a USB drive, installing, starting up and updating.

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 seeWhat to do
/dev/sda isn't a USB drive or a removable disknami 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 partitionGive the whole drive: /dev/sdb, not /dev/sdb1.
/dev/sdb holds 7.8 GB; the image needs 8.5 GBUse a drive of 16 GB or more.
writing ... erases it: run in a terminal to say yes, or pass --yesRun it in a terminal, or add --yes.
no password, and no terminal to ask for oneRun it in a terminal, or use --password-stdin.

Fix an install that won’t start

What you seeWhat to do
start the computer from the USB drive firstnami install-to only runs on a computer started from a drive nami usb made.
Windows is hibernated, or has Fast Startup onStart Windows and shut it down fully: hold Shift while you click Shut down.
Windows' EFI partition ... is fullnamiOS’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

WhatWhere
Daily updatesjournalctl -u nami-update
Your first loginjournalctl --user -u nami-first-login
The computer’s servicesjournalctl -u <name>
Your own servicesjournalctl --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.

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