~/user.nami
packages:
  - firefox
  - spotify
  - vscode
FirefoxSpotifyVS Code

nami 0.18.11

The declarative manager for Linux.

Your whole Linux setup in one file.

Try

    Apps

    Any app, in any version.

    Ready-built from nixpkgs, each with its own libraries, so nothing clashes with your distro.

    terminal
    $ nami install firefox
    + firefox-150.0.1
    $ nami install python3@3.12  # newest 3.12.x

    Your setup

    Apps, dotfiles and settings. One file.

    Put ~/user.nami in git, and every computer you use is set up the same way.

    ~/user.nami
    # your setup, on every computer
    packages:
      - zsh:
          login-shell: true
      - git:
          ~/.gitconfig:
            user: { name: Ada }
    aliases:
      ll: eza -l --git
    env:
      EDITOR: hx
    settings:
      org.gnome.desktop.interface:
        color-scheme: prefer-dark

    Changes

    Undo any change.

    Every install, removal and upgrade can be taken back instantly, with nothing to download.

    terminal
    $ nami history
         2  2026-10-12 09:20 UTC  3 packages
         3  2026-10-15 18:02 UTC  3 packages
    *    4  2026-10-19 08:41 UTC  4 packages
    $ nami undo
    back at change 3
    - vlc-3.0.21

    Projects

    Give each project its own tools.

    Everyone who clones it gets the same tools, tasks and services, at the same versions.

    ~/code/shop/project.nami
    # project.nami, in the project's folder
    packages:
      - nodejs: 22
      - ripgrep
    tasks:
      test: npm test
      dev: npm run dev
    services:
      - ./services/postgres.nami
    terminal
    $ cd shop && nami shell
    $ nami run test

    nami bundle

    Ship your app as one file.

    It runs on Ubuntu, Fedora, Debian, Arch and the rest, old and new, with nothing to install first, and it keeps itself up to date.

    Learn about nami bundle

    Sync

    The same setup on all your computers.

    Add an app on your laptop, and it shows up on your desktop, through a git repository of your own.

    laptopUbuntu+ blender
    github:ada/nami-config
    desktopFedora+ blender

    The nami app

    Prefer clicking? Use the app.

    Find apps, keep your setup, run projects and go back in time, without a terminal.

    Discover in the nami app, with a search for apps and tools, the kinds of app, today's app and the most popular apps, each with GetDiscover in the nami app, in dark mode

    nami and Nix

    All of nixpkgs, without learning Nix.

    nami is its own package manager. It installs nixpkgs' ready-built packages, and never needs Nix.

    What you write.

    nami4 lines
    ~/user.nami
    packages:
      - firefox
      - nodejs: 22
      - ripgrep
    Nix25 lines
    ~/.config/home-manager/flake.nix
    {
      inputs = {
        nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
        home-manager.url = "github:nix-community/home-manager";
        home-manager.inputs.nixpkgs.follows = "nixpkgs";
      };
    
      outputs = { nixpkgs, home-manager, ... }: {
        homeConfigurations.ada = home-manager.lib.homeManagerConfiguration {
          pkgs = nixpkgs.legacyPackages.x86_64-linux;
          modules = [
            ({ pkgs, ... }: {
              home.username = "ada";
              home.homeDirectory = "/home/ada";
              home.stateVersion = "25.11";
              home.packages = with pkgs; [
                firefox
                nodejs_22
                ripgrep
              ];
            })
          ];
        };
      };
    }

    When you make a typo.

    nami1 line
    terminal
    $ nami check project.nami
    project.nami:3: error: ripgrpe isn't in the catalog (did you mean `ripgrep`?)
    Nix26 lines
    terminal
    $ nix-shell
    error:
           … while calling the 'derivationStrict' builtin
             at «nix-internal»/derivation-internal.nix:37:12:
               36|
               37|   strict = derivationStrict drvAttrs;
                 |            ^

    + 20 more lines

    Faster, and smaller.

    Search all packages

    nami11 ms Nix1.3 s

    New computer, three tools installed

    nami4.3 s Nix8.4 s

    Start a project's tools again

    nami8 ms Nix0.07 s

    What you install

    nami33 MB Nix114 MB

    Measured November 19, 2026: nami 0.18.7 and Nix 2.35.6, the same nixpkgs from cache.nixos.org, the middle of three runs, each in a new container. How we measured

    Already use Nix? nami works next to it, and nami import turns your setup into nami files.

    One tool

    One tool, instead of juggling many.

    Install apps apt, dnf, pacman, Flatpak, Homebrew nami install
    Pick a version PPAs, building it yourself firefox: 150
    A project's tools nvm, pyenv, rbenv, asdf, mise, devbox, devenv, direnv project.nami
    A project's database Docker Compose nami up
    Try a tool once npx, pipx run, nix-shell -p nami run-once
    Your dotfiles chezmoi, GNU Stow, yadm ~/.gitconfig:
    Your secrets sops, agenix !secret
    Every computer alike Setup scripts, Ansible nami sync
    Ship your app AppImage, Snap, a package per distro nami bundle

    And there's more.

    • Apps from Flathubflathub:
    • Install a downloaded .debnami install ./app.deb
    • Turn a .deb into a packagenami recipe from-deb
    • Build your own packagespackage.nami
    • Ship your app as one filenami bundle
    • Passwords, safe in git!secret
    • Folders in sync, no cloudSyncthing
    • Services from your filesystemd
    • One repo for all your computersconfig repos
    • Build on shared layersnami layers
    • Build once, share the resultnami push
    • Bring your Ubuntu or Nix setupnami import
    • Tools load as you cdnami hook
    • Run a tool without installing itnami run-once
    • Just for you, or for everyone--for-everyone
    • See what changednami diff
    • Keep an app's own editsnami home
    • Checks as you typeVS Code, Helix, Neovim
    • Find and report problemsnami doctor
    • Your distro left as it wasnothing in /usr

    Ready for a fresh start? Try namiOS in a window, from the nami app. namiOS

    Install nami on the distribution you have.

    Paste this into a terminal on Ubuntu, Fedora, Mint, Arch or any other distribution on x86_64. It takes a minute or two.

    $ curl -fsSL https://namios.dev/install | sh

    alphanami is alpha software: most things work, some may not yet, and you can undo every change.

    Other downloads: tarball · checksums

    Install nami, step by step

    Get updates by email

    We'll email you about new versions of nami, and nothing else. Privacy

    Or start fresh with namiOS

    01namiOS
    A declarative Linux distribution, built on nami

    Instead of Windows or next to it, with the desktop and apps ready.

    Join the namiOS Alphafor a fresh start
    02nami
    For the distribution you already have

    Keep Ubuntu, Fedora, Mint or Arch, and add nami on top.

    for Ubuntu, Fedora, Mint and Arch