Raspberry Pi Image

The fastest way to get Smart Panel running on a Raspberry Pi. Pre-built images include everything — just flash, boot, and configure WiFi.

Choose Your Image Variant

All-in-One

All-in-One (AIO)

Backend + admin + display app on one device. Best for standalone smart panels with a touchscreen.

This is the most common setup — a single Raspberry Pi serves as both the server and the display.

Flash the Image

Download the image

Go to GitHub Releases and download the image for your variant. Files are named:


smart-panel-{variant}-{version}-arm64.img.xz

Where {variant} is aio, server, or display.

Flash using Raspberry Pi Imager

Open Raspberry Pi Imager and follow these steps:

1. Select your Raspberry Pi model

Select device

2. Choose the downloaded image — select “Use custom” and pick the .img.xz file

Select image

3. Select your SD card

Select drive

4. Review the summary and click Write

Confirm write

5. Confirm that all data on the SD card will be erased

Confirm wipe

6. Wait for the image to be written

Writing progress

7. Done — remove the SD card

Write finished

Boot the Pi

Insert the SD card into your Raspberry Pi and power it on.

Images are ARM64 only — compatible with Pi 3B+, Pi 4, Pi 5, and Pi Zero 2W (64-bit).

Configure WiFi

Option A: Captive Portal (no computer needed)

On first boot, if no WiFi is configured, a WiFi hotspot named SmartPanel-XXXX appears (password: smartpanel).

Connect from your phone — a setup page opens automatically
Enter your WiFi credentials, country code, and optional hostname/timezone
Click Save & Connect — the device joins your network

See Captive Portal for full details.

Option B: Boot partition config file

Before first boot, create a file called smart-panel.conf on the SD card’s boot partition:


WIFI_SSID=MyNetwork
WIFI_PASSWORD=mypassword
WIFI_COUNTRY=US
HOSTNAME=smart-panel
TIMEZONE=America/New_York

All fields are optional. If WiFi fields are present, the captive portal is skipped.

First Boot

What happens on first boot:

Root partition auto-expands to fill the SD card
WiFi connects (via captive portal or boot config)
Native modules are compiled (may take a few minutes on first boot)
Database is migrated
Services start automatically

First boot takes 2–5 minutes depending on your Pi model. A log is written to /boot/firmware/smart-panel-firstboot.log for diagnostics.

Post-Installation

Default SSH Credentials

The pre-built image ships with the following default credentials:

Username: smartpanel
Password: smartpanel

On first SSH login, you will be prompted to change the default password.

Access the Admin Interface

From another device on the same network, open a browser:


http://smart-panel.local:3000

Or use the hostname you configured in place of smart-panel.

View Logs


# Backend
sudo journalctl -u smart-panel -f
 
# Display (AIO/Display variants)
sudo journalctl -u smart-panel-display -f

What’s Next?

Your Smart Panel is running. Head over to Onboarding to create your admin account and start configuring your dashboard.