nami alpha Docs

Moving in

Bring your apps, settings and files to namiOS from another distribution, an old Ubuntu computer or Windows.

Move to namiOS from your distribution

If you use nami on Ubuntu, Fedora, Mint or Arch, the nami app has a Move to namiOS page. Click Try namiOS in a Window to try it first, then make a namiOS USB drive with your apps and settings on it.

When namiOS starts from that drive for the first time, it sets you up from the same user.nami you have now. namiOS replaces your distribution on the disk you install it on, so back up your files first. Your documents and photos don’t go on the drive: copy them over afterwards, as in Copy your files.

Bring your setup from an old computer

On an old Ubuntu or Debian computer, nami import reads what you use and writes it into a config repo at ~/nami-config:

sudo nami import /          # sudo also brings the Wi-Fi networks
nami import / --dry-run     # show what it would write, secrets hidden
~/nami-config/
├── laptop/
│   ├── computer.nami       # the apps, Wi-Fi, hostname, language, you
│   └── ada/user.nami       # your settings, shell, dotfiles and toolchains
└── packages/               # nami's examples it uses

Nothing on the old computer changes, and nothing is applied. Wi-Fi passwords and tokens are sealed as secrets before anything is written.

Know what comes along

On the old computerIn the repo
apt packages, snaps and flatpaks you installedpackages:, by their catalog names
Windows programstheir Linux versions, such as Chrome, VS Code, Spotify and Steam
Wi-Fi networkswifi:, with the passwords sealed
GNOME settings, favourite apps and extensionssettings:, the Dock’s apps and extension packages
hostname, time zone, language and keyboardthe same keys in computer.nami
your shell and what you added to .bashrc or .zshrcenv:, aliases: and shell:
small dotfiles such as .gitconfig and .ssh/configfiles:
Docker and Tailscaletheir add-ons

Libraries, the kernel and firmware stay behind, as do programs you installed by hand and private keys. Each one left out is listed, with the reason, at the end of both files. Run the import again after you install something; it merges and never replaces what you changed.

Bring your setup from Windows

Windows’ settings can only be read while Windows isn’t running. Shut Windows down fully by holding Shift while you click Shut down, start the computer from a namiOS USB drive, and run:

sudo nami import /mnt/c     # Windows' disk, mounted

Windows keeps Wi-Fi passwords locked to itself. To bring them, first run netsh wlan export profile key=clear folder=C:\wifi in Windows, and delete that folder after the import.

Make the new computer

  1. Read the two files, change what you like, and run nami check ~/nami-config/laptop.
  2. Push the repo to a private git repository.
  3. Make a USB drive with nami usb github:ada/nami-config/laptop, and install it as described in Make your own computer.

To keep your distribution instead, run nami apply github:ada/nami-config on it.

Copy your files

Your documents, photos and projects don’t go in the repo. On namiOS, open Transfer Your Files in Settings: it finds the old disk and copies what you choose. In a terminal:

nami import /mnt/c --home ~                           # everything, from Windows' disk
nami import /mnt/c --home ~ --only Documents,firefox  # some of it

If it stops, run the same command to carry on. Firefox and Thunderbird open as they were. Chrome’s saved passwords can’t come from Windows, so export them in Chrome first.

To move files from an old Linux computer, copy its home to a USB disk with nami import / --home /media/ada/disk/home, then run nami import /media/ada/disk/home --home ~ on namiOS.

Come from Nix

To bring a NixOS configuration, home-manager or a flake’s dev shell, see Bring your Nix setup.

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