Guide

Installation Guide

From download to a running system — no internet required at any step.

Before you begin

You need: a computer that meets the system requirements, a USB stick of 4 GB or more (it will be erased), and — if the computer holds anything precious — a backup of your files.

1. Download and verify

Download the ISO from the download page, then verify it against the SHA256 checksum printed there:

sha256sum basalt-linux-1.3-amd64.iso

The long code it prints must match the one on the download page exactly. This proves your copy is complete and untouched.

2. Write the ISO to USB

  • On Windows: use Rufus or Balena Etcher — select the ISO, select the USB stick, write.
  • On Linux: use Balena Etcher, or from a terminal:
  • sudo dd if=basalt-linux-1.3-amd64.iso of=/dev/sdX bs=4M status=progress

    Replace sdX with your USB device. Be careful: the target disk is erased.

3. Boot from the USB

Restart the computer and open its boot menu (often F12, F9, Esc or Del, depending on the maker) and choose the USB stick. Basalt supports both UEFI and legacy BIOS, and Secure Boot can stay on. You will land in the live system — the full desktop, running from USB. Nothing on your hard disk has changed yet; feel free to look around first.

4. Install

  1. Double-click Install Basalt Linux on the desktop. The Calamares installer opens.
  2. Choose your language and keyboard layout.
  3. At the partitioning step, Erase disk is the simple, recommended choice. (To keep an existing Windows system, choose the alongside option instead.)
  4. Create your user account. This first account is the administrator — there is no separate root password to remember.
  5. Confirm the summary and let the installation run. It works fully offline.

5. Restart

When the installer finishes, restart and remove the USB stick when asked. Your new Basalt system starts, ready to use.

Stuck at any step? The troubleshooting guide covers the common problems, and the Discord community is there if you need a hand.