FiestaPi Quick Start

The easiest way to run FiestaBoard. Flash a microSD card, boot your Pi, open a browser — done.

No Docker setup. No command line. Self-updating out of the box.

What's in the box

FiestaPi is a pre-built Raspberry Pi OS image with FiestaBoard, Docker, and the self-update sidecar all pre-installed and configured to start on boot. All you do is flash and go.

What You Need

• Raspberry Pi 3B or newer (Pi 4 / Pi 5 work great too)
• A microSD card — 8 GB minimum, 16 GB+ recommended
• A 5V power supply for your Pi
• Your Pi on the same network as your Vestaboard or split-flap display
• Your board's API key (where to find it)

Step 1 — Download the FiestaPi image

👉 Download the latest FiestaPi image

On the Releases page, grab the file named fiestapi-<version>-arm64.img.xz.

Not sure which file to pick?

Download the .img.xz file. It's compressed — Raspberry Pi Imager handles decompression automatically.

Step 2 — Flash the microSD card

The simplest tool is Raspberry Pi Imager (free, works on Mac/Windows/Linux):

1. Open Raspberry Pi Imager
2. Click Choose Device → select your Pi model
3. Click Choose OS → scroll to the bottom → Use custom → pick the .img.xz you downloaded
4. Click Choose Storage → select your microSD card
5. Click Next — Imager will ask if you want to apply OS customisations
6. Recommended: click Edit Settings to pre-configure:
   • Your Wi-Fi network name and password (so the Pi connects automatically)
   • Your timezone
7. Click Write and wait ~5 minutes

Alternative tools: Balena Etcher works too. On Linux/macOS with dd:

xz -d fiestapi-<version>-arm64.img.xz
sudo dd if=fiestapi-<version>-arm64.img of=/dev/<your-sd-card> bs=4M status=progress

Adding Wi-Fi credentials without Raspberry Pi Imager

If you flashed with Balena Etcher or dd and didn't set Wi-Fi credentials during flashing, you can still configure Wi-Fi headlessly — no keyboard or monitor needed.

After flashing, plug the SD card back into your computer. A small FAT32 drive called bootfs will appear (visible from any OS without special tools).

1. Create a file called fiestapi-wifi.txt in the root of the bootfs drive

2. Paste in your Wi-Fi details:

   SSID=YourNetworkName
   ******

3. Save the file and eject the SD card

On first boot FiestaPi reads the file, connects to Wi-Fi, and immediately deletes the file so your credentials are never left sitting on the readable FAT partition. For open (password-free) networks, omit the PASSWORD line entirely.

Already used Raspberry Pi Imager's OS customisation?

If you already entered Wi-Fi credentials via Imager's settings screen, the fiestapi-wifi.txt file isn't needed — Imager handles it for you.

Step 3 — Boot your Pi

1. Insert the microSD card into your Pi
2. Plug it in
3. Wait 2–3 minutes — the first boot is longer than usual (it expands the filesystem and pulls Docker images)

That's it. FiestaBoard starts automatically.

Step 4 — Open FiestaBoard

On any device on the same network, open:

→ http://fiestapi.local:4420

You'll see the FiestaBoard setup wizard. Enter your board API key, choose your board type, and you're running.

Can't reach fiestapi.local?

.local addresses use mDNS. It works on Mac, iOS, Android, and most Linux systems out of the box. On Windows, you may need Bonjour Print Services if it's not already installed. As a fallback, find the Pi's IP address in your router's admin page and use that directly: http://192.168.x.x:4420.

Updating FiestaBoard

When a new version is released, a banner appears in Settings → System with an Update Now button. Tap it — FiestaBoard updates itself and the page reloads when it's done. No SSH, no terminal.

Auto-update is enabled by default on FiestaPi. See In-App Updates for more detail.

Default credentials

Thing	Default
Hostname	fiestapi.local
Web UI port	4420
SSH user	fiesta
SSH password	fiestaboard

Change your SSH password

On first SSH login, run passwd to set a strong password.

Troubleshooting

Pi won't connect to Wi-Fi — If you didn't set Wi-Fi credentials in Raspberry Pi Imager, drop a fiestapi-wifi.txt file on the bootfs partition (see Adding Wi-Fi credentials without Raspberry Pi Imager above). Alternatively, re-flash using Raspberry Pi Imager's Edit Settings screen to pre-configure Wi-Fi. Or plug in an Ethernet cable and set Wi-Fi up later via SSH.

FiestaBoard isn't starting — SSH in (ssh fiesta@fiestapi.local) and check logs: docker logs fiestaboard. If Docker images haven't pulled yet, wait another minute.

I want to SSH in — ssh fiesta@fiestapi.local (default password fiestaboard — change it!).

Can I run this on a Pi Zero 2 W? — Yes, but it's tight on RAM. Disable unused plugins to reduce memory pressure.

Where's my data if I re-flash? — FiestaBoard data lives in /opt/fiestaboard/data/. Back it up with scp -r fiesta@fiestapi.local:/opt/fiestaboard/data/ ./backup before re-flashing.