Skip to content

Installing the Nightly Build

Fayaaz Ahmed edited this page Jun 21, 2026 · 2 revisions

This guide covers how to flash the Mixxx Pi nightly image to an SD card. This image is unstable and has not been tested but contains up to date versions of Debian and Mixxx.

Requirements

  • Raspberry Pi 3, 4, 400, or 5
  • SD card (16GB or larger recommended)
  • PC with SD card slot or USB SD card reader
  • Image file from the Nightly Release

Download the Image

  1. Go to the Nightly Release page
  2. Download the mixxx-pi-*.zip file under Assets
  3. Extract the .img file

Flash the SD Card

Using Balena Etcher (Recommended)

  1. Download and install Balena Etcher
  2. Click Flash from file and select the .img file
  3. Click Select target and choose your SD card
  4. Click Flash

Using dd (Linux/macOS)

# Identify your SD card device (e.g., /dev/sdX or /dev/diskN)
lsblk

# Flash the image (replace X with your device)
sudo dd if=mixxx-pi.img of=/dev/sdX bs=4M status=progress conv=fsync

First Boot Setup

  1. Insert the SD card into your Pi
  2. Connect power, monitor, keyboard, and optionally ethernet
  3. Power on - Mixxx should start automatically after ~60 seconds

Clone this wiki locally