Pre-configured images available for download and their use cases.

All images available in GitHub Releases.

Description: Minimal Debian 13 (Trixie) with RaspiOS kernel and firmware

Services included:

• base (RaspiOS kernel, NetworkManager, SSH)

Size: ~512MB compressed

RAM required: 2GB minimum

Use cases:

• Minimal Debian installation
• Custom development base
• Learning/testing Raspberry Pi

Default login:

• Username: pi
• Password: raspberry

Download:

wget https://github.com/Pikatsuto/raspberry-builds/releases/latest/download/debian-base.img.xz

Description: Debian with Incus virtualization and Docker Engine

Services included:

• base
• qemu (Incus + KVM)
• docker (Docker Engine + Portainer + Watchtower)

Size: ~4-5GB compressed

RAM required: 4GB minimum (8GB recommended)

Use cases:

• Container host (Docker + Incus)
• Development platform
• Microservices deployment
• VM/container testing

Access:

• Portainer: https://raspberry-ip:9443
• Incus: incus list (SSH)

Download:

wget https://github.com/Pikatsuto/raspberry-builds/releases/latest/download/debian-qemu-docker.img.xz

Description: Debian with OpenWrt router and WiFi hotspot

Services included:

• base
• qemu (Incus)
• openwrt (OpenWrt container)
• hotspot (WiFi AP)

Size: ~3-4GB compressed

RAM required: 4GB minimum

Hardware required:

• Dual NIC (eth0 + eth1) or single NIC
• WiFi adapter(s) for hotspot

Use cases:

• Network router/firewall
• WiFi access point
• VPN gateway
• Network segmentation

Access:

• OpenWrt LuCI: http://192.168.10.1
• WiFi SSID: RaspberryPi-5G (password: raspberry)

Download:

wget https://github.com/Pikatsuto/raspberry-builds/releases/latest/download/debian-qemu-openwrt-hotspot.img.xz

Description: Complete home automation and network platform

Services included:

• base
• qemu (Incus + KVM)
• docker (Docker Engine + Portainer)
• openwrt (OpenWrt router)
• hotspot (WiFi AP)
• haos (Home Assistant OS)

Size: ~6-8GB compressed

RAM required: 8GB (Raspberry Pi 5 8GB recommended)

Hardware required:

• Dual NIC (eth0 + eth1) recommended
• WiFi adapter(s) for hotspot
• Optional: Zigbee/Z-Wave USB dongle

Use cases:

• Complete home automation gateway
• Network router + WiFi + smart home
• All-in-one Raspberry Pi solution

Access:

• Home Assistant: http://raspberry-ip:8123
• Portainer: https://raspberry-ip:9443
• OpenWrt LuCI: http://192.168.10.1
• WiFi SSID: RaspberryPi-5G

Download:

wget https://github.com/Pikatsuto/raspberry-builds/releases/latest/download/debian-qemu-docker-openwrt-hotspot-haos.img.xz

Recommended for production use

• Tested and verified
• No pre-release flag
• Downloaded from latest release

Download:

# Latest stable
wget https://github.com/Pikatsuto/raspberry-builds/releases/latest/download/<image-name>.img.xz

For testing new features

• Pre-release builds
• May contain bugs
• Use for testing only

Download:

# Browse releases and select test build
# URL: https://github.com/Pikatsuto/raspberry-builds/releases

Experimental builds

• Bleeding-edge features
• Unstable
• Use at your own risk

Automatic daily builds at 2:00 AM UTC

Tag format: daily-YYYY-MM-DD

Purpose:

• Captures latest base image updates
• Tests build system
• Provides fresh images daily

Download:

# Today's build
wget https://github.com/Pikatsuto/raspberry-builds/releases/download/daily-2024-12-08/<image-name>.img.xz

Note: Daily builds overwrite previous daily release. Download and archive if needed.

Choose image from above, download via browser or wget.

Verify checksum:

sha256sum <image-name>.img.xz
# Compare with .sha256 file from release

Linux:

xz -dc <image-name>.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
sync

macOS:

xz -dc <image-name>.img.xz | sudo dd of=/dev/rdiskX bs=4m
sync

Windows:

• Use Balena Etcher
• Select .img.xz file
• Select SD card
• Flash

• Insert SD card
• Connect Ethernet (recommended for first boot)
• Power on
• Wait 3-5 minutes for first-boot setup
• Find IP address from router or MOTD on login

All images can be customized post-installation:

Update system:

sudo apt update && sudo apt upgrade -y

Install additional packages:

sudo apt install <package-name>

Add Docker containers (if Docker image):

docker run -d <container-image>
# Or use Portainer web UI

Create Incus containers/VMs (if qemu image):

incus launch images:alpine mycontainer
incus launch images:debian myvm --vm

Don’t see the image you need? Build your own!

See: Creating Custom Images

Quick example:

git clone https://github.com/Pikatsuto/raspberry-builds.git
cd raspberry-builds

# Build custom combination
./bin/autobuild --image debian/qemu+docker+haos

# Or create entirely custom image
cp -r images/debian images/myproject
vim images/myproject/config.sh
./bin/autobuild --image myproject

Issues with images:

• Report bug
• Request feature
• Ask question

Image documentation:

• Getting Started
• FAQ
• Troubleshooting