Download · latest tag v0.3.0-beta

Get Blueberry Linux

Write the image to a USB stick, boot it in QEMU, or build the whole system from source in minutes. x86-64, UEFI + BIOS.

Server ISO

Minimal rolling CLI. Boots to an interactive shell from RAM in seconds; run blueberry-install to put it on disk.

busybox + bash x86-64 ~60 MB

Download ISO

SHA-256: see SHA256SUMS in the release

From source

The whole supply chain is yours — clone the monorepo and build a bootable world with a handful of make targets. No image download required.

gcc + make qemu ~minutes

Build guide →

Default root password is blueberry — change it before exposing the box.

Write & boot

From image to running system.

write to USB

# replace sdX with your USB device
sudo dd if=blueberry-server-x86_64.iso \
     of=/dev/sdX bs=4M status=progress oflag=sync

test the ISO in QEMU (headless)

qemu-system-x86_64 \
  -cdrom blueberry-server-x86_64.iso \
  -m 512M -nographic

SSH into a box

ssh root@<box-ip>   # password: blueberry

install to disk

# blueberry-install   # guided GPT/UEFI installer

Or build from source

Prerequisites: gcc, make, curl, zstd, cpio, qemu (core build); podman/docker, xorriso (ISO).

clone, build, boot

$ git clone https://github.com/zsigisti/blueberry.git
$ cd blueberry
$ make _check_tools
$ make world
$ make run

Looking for tagged builds? See the Releases page.