Download

Pick a desktop. You get one file to put on a USB stick and install from.

Based on

Experience

Changing experience starts a new setup. Finish any build or save first.

ISO builder

Make your own image

Installation and USB writer guidance

Follow the selected system’s writer and hardware guidance. A tool working for one system does not establish support for another.

Installation documentation

1. Choose your system
2. Check the target computer
3. Personalize (optional)
4. Review & create
5. Save & install

Planning on a phone? Choose a setup here, then use the setup link below to continue on a desktop. The link carries supported choices; it does not upload files or create a cloud account.

Choose your desktop

The desktop is how your computer looks and feels. Choose the layout you prefer. Your selection does not guarantee that a browser build is available.

Change Linux base or computer type

Linux base

Computer type

Use a custom container image

Bootable container image

Check your target computer

Use the specifications of the computer you will install on, even if you are planning on a phone or another computer. We do not infer compatibility from this browser.

Find the architecture and hardware requirements

On Windows, open Settings → System → About and find System type and processor. On macOS, use About This Mac. On Linux, open system information or run uname -m for the architecture.
Intel/AMD x86-64 and ARM64 are different targets. An x86-64 result alone does not establish the v2 or v3 CPU baseline. Check the processor specifications against the selected image requirements.
Apple Silicon and Apple T2 Macs need explicitly supported hardware paths. Generic ARM64 or Intel/AMD media does not establish Mac support.
Check graphics, firmware and boot requirements in the selected system’s installation documentation. An available catalog image is not a hardware compatibility test.

Plan your apps Optional

Choose optional apps from Flathub. Your choices are saved as an app request list. These requests are not yet applied to the live image or installed system.

Choose apps 0 selected

No extra apps selected. Check the image to load its suggested defaults.

Defaults have not been checked for this image.

Terminal, browser and installer coverage is unknown. The image does not provide verified app-role inventory. Native or bundled apps may supply these roles; requested Flathub additions are separate and are not applied yet.

Search Flathub

Type at least 3 characters to search.

Add an app collection

Collections are maintained by other Linux projects. Review the selected apps after adding one.

Check your image

We’ll check whether this image can be built in your browser before starting a download.

Advanced settings

Configuration source (TOML)

Branding, catalog choices and defaults come from the primary tunaos.toml configuration and its validated export. This form edits a build request; it is not a complete TOML editor.

TOML import and lossless editing are not available here yet. Keep your original TOML, including advanced fields. Fork maintainers should use the configuration export workflow. BuildRequest JSON is engine transport, not a replacement configuration.

The defaults work for most people. Only change these if you need a specific system setup.

USB image name

Add system packages

System packages (layered on the installed system via remora — persists across updates)

Search system packages

Add a repository or setup command

These are advanced setup commands, not verified app sources. Review their effects and trust the publisher. Never enter private keys or tokens.

I trust this source and have reviewed this command.

Repository or command

Override boot files or registry connection

tbox initramfs URL (optional override — by default the builder appends the tbox live modules to the image's own initramfs automatically) Registry relay URL (CORS shim)

Manage downloaded files

Downloaded layers (kept in browser storage so the next build of an image downloads nothing it already has)

—

No ISO download starts yet.

Build on your own machine

Build this exact target locally, without browser memory or storage limits. Save build-request.json, then run the command below in the same folder. It needs Go 1.26 or newer and access to the image registry, and writes the ISO to ./tunaos-pure.iso.

go run github.com/tuna-os/tacklebox/cmd/purebuild@latest --request build-request.json

Inspect BuildRequest v1 JSON

{}

Save, verify, and install

Creating an ISO does not write a USB drive or test an installation. Confirm the file has saved before continuing.

Saving does not independently verify the saved file. Input digest checks establish byte integrity, not publisher authentication. A successful build does not establish that this ISO boots or installs on your computer.

Download and install BalenaEtcher (supports Windows, macOS, and Linux).
Use a USB drive with capacity larger than the downloaded ISO file. Back up its files and verify the selected drive before flashing; flashing erases its contents.
Open Etcher, click Flash from file and select your downloaded ISO.
Select your USB target and click Flash!.

Warning: writing to the wrong drive wipes it. Check the device name first.

Identify your USB drive name (e.g. /dev/sdX on Linux, /dev/diskN on macOS).

Run the following command in your terminal:

sudo dd if=path/to/image.iso of=/dev/sdX bs=4M status=progress oflag=sync

Wait for the write command to complete and safely eject the drive.

Save planning choices for a refresh

Save supported catalog choices, app requests, packages and the image label in this tab’s session storage. Nothing is uploaded. Restoring never starts a build or restores trust acknowledgements. Custom images, commands, connection overrides, TOML and secrets are not supported. Use the setup link to move supported choices to a different computer.