- Ubuntu 20.04
- Ubuntu 24.04
- Debian 12
- Fedora 45
- Arch Linux
- openSUSE
- Linux Mint 22.3
- namiOS
Every distribution
One file for old and new distributions.
A bundle carries everything the program needs, down to glibc. Only the graphics driver, fonts, locale and certificates come from the computer.
- Ubuntu 20.04
- Ubuntu 24.04
- Debian 12
- Fedora 45
- Arch Linux
- openSUSE Tumbleweed
- Linux Mint 22.3
- namiOS
| App | Ubuntu20.04 | Ubuntu24.04 | Debian12 | Fedora45 | Arch Linux | openSUSETumbleweed | Linux Mint22.3 | namiOS |
|---|---|---|---|---|---|---|---|---|
| Open SurgeGame · 225 MiB | Runs | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| simpRust, wgpu · 24 MiB | – | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| StrawberryQt 6 · 358 MiB | Runs | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| RnoteGTK 4 · 263 MiB | – | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| AmberolGTK 4 · 267 MiB | – | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| ElementElectron · 416 MiB | Runs | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| tmuxCommand · 14 MiB | Runs | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
| aria2Command · 22 MiB | Runs | Runs | Runs | Runs | Runs | Runs | Runs | Runs |
- Open SurgeGame · 225 MiBAll eight
- simpRust, wgpu · 24 MiBAll but Ubuntu 20.04
- StrawberryQt 6 · 358 MiBAll eight
- RnoteGTK 4 · 263 MiBAll but Ubuntu 20.04
- AmberolGTK 4 · 267 MiBAll but Ubuntu 20.04
- ElementElectron · 416 MiBAll eight
- tmuxCommand · 14 MiBAll eight
- aria2Command · 22 MiBAll eight
Eight open-source apps, each bundled once on Ubuntu 24.04, then started on each distribution. On Ubuntu 20.04's and Debian 12's older Mesa, Rnote's and Amberol's windows stay black on X11; a bundle made with --mesa draws.
Updates
Your app keeps itself up to date.
Publish a new version, and every copy downloads only what changed, signed with your key.
$ nami bundle . --update-url github:ada/myapp --publish-dir release/ $ gh release create v1.2.0 release/*
$ ~/Apps/myapp-x86_64 --nami-bundle-update /home/ada/Apps/myapp-x86_64: updated myapp from 1.1.0 to 1.2.0 downloaded 3 of its 38 parts (1.2 MiB, only what changed in each); the rest it had already
- Only what changedEach copy looks once a day and downloads only what changed in each part. FeatherPad 1.6.4 is 72 MiB in place of 139 MiB.
- Only from youA copy takes an update only if it's signed with your key.
- At the next startThe new version takes over the next time the app opens, never while it runs.
Projects
Bundle your project as it is.
nami builds Rust, Go, C and C++, Python, Node.js, Electron, Zig, Flutter and .NET projects with its own tools, so you don't need a recipe or the tools installed.
- Rust
Cargo.toml - Go
go.mod - C and C++
meson.build, CMakeLists.txt - Python
pyproject.toml - Node.js, Electron
package.json - Zig
build.zig - Flutter
pubspec.yaml - .NET
.csproj
bundle: name: myapp version: 1.2.0 program: myapp icon: assets/myapp.svg desktop: assets/myapp.desktop
$ nami bundle ./packages/myapp # a recipe folder $ nami bundle jq # a package from the catalog $ nami bundle ./target/release/myapp # a program you built $ nami bundle myapp-1.0-linux-x86_64.tar.gz # a release tarball
Releases
A bundle with every release.
Add nami-bundle-action to your workflow. Push a tag such as v1.2.0, and the release gets myapp-x86_64 and its .sha256 file.
name: Release on: push: tags: ['v*'] permissions: contents: write jobs: linux: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - uses: jensbirk/tray/action@main
- One link to the newestThe file's name has no version, so
releases/latest/download/myapp-x86_64always points at the newest. - One click on namiOSOn namiOS, a downloaded bundle opens in Settings, ready to install, like a
.deb.
Compare
How it compares.
Each way of shipping a Linux app makes a trade. Here's where a bundle stands next to AppImage and Flatpak.
| Feature | nami bundle | AppImage | Flatpak |
|---|---|---|---|
| Needs nothing installed | Yes | Needs FUSE | Needs Flatpak |
| Works on old and new distributions | Carries its own glibc | Uses the computer's glibc | Through its runtimes |
| Updates itself with only what changed | Yes | With AppImageUpdate | Through Flatpak |
| Signed updates | With your key | Optional | Yes |
| Sandbox | Optional | – | Yes |
| Size | Biggest: everything, down to glibc | Smaller: uses the computer's libraries | Runtimes shared between apps |
Need an AppImage as well? nami bundle --appimage writes one beside the bundle.
Limits
Know the limits.
A bundle is made for one kind of computer, and it's bigger than a package.
- Made for x86_64 and glibcNot musl distributions like Alpine. On ARM,
--arch aarch64bundles command-line programs from the catalog, without updates for now. - Sandboxed only if you say soAnd only where the computer has bubblewrap. Otherwise a bundle runs with the person's rights. Bundle only software you may hand out.
- Bigger filesIt carries every file the program refers to. With
--thin, the common parts download on the first start. - A slower first startThe first start unpacks what isn't there yet, a few seconds for a GTK app.
/tmpmust be writable.
| Bundle | File | Unpacked |
|---|---|---|
jq | 10.4 MiB | 37.6 MiB |
featherpadQt 6 | 143 MiB | 729 MiB |
gnome-text-editorGTK 4 | 264 MiB | 964 MiB |
All bundles unpack into one shared store, so GTK or glibc is on the disk once, however many bundles carry it.
Install
Start shipping with nami.
nami bundle comes with nami. Paste this into a terminal on any distribution on x86_64, then run nami bundle in your project.
Every option, step by step: Ship your app