Beginner's Guide

Never used Docker or the command line before? No problem. This guide walks through every step clearly, from installing Docker to seeing your first content on the board.

Time needed: About 15 minutes.

What You'll Need

• A computer (Mac, Windows, or Linux)
• A split-flap display that's already set up and working with the board's app
• Your board's API key (Step 2 below shows you where to find it)
• An internet connection

Step 1: Install Docker

Docker is free software that runs FiestaBoard in a self-contained package. You only need to install it once.

Mac

1. Go to Docker Desktop for Mac
2. Click Download (choose Intel or Apple Silicon based on your Mac)
3. Open the downloaded file and drag Docker to your Applications folder
4. Open Docker Desktop from Applications - it will ask for permission to run
5. Wait for Docker to finish starting (the whale icon in your menu bar will stop animating)

Windows

1. Go to Docker Desktop for Windows
2. Click Download for Windows
3. Run the installer and follow the prompts (enable WSL 2 if asked)
4. Restart your computer if prompted
5. Open Docker Desktop - it should start automatically

Linux

Open a terminal and run:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Log out and back in after running these commands, then verify Docker is working:

docker --version

Step 2: Get Your Board API Key

Your board API key is what lets FiestaBoard talk to your display. You can use either the Local API or the Cloud API.

Local API (Recommended)

This is faster and supports transition animations. Your board and computer need to be on the same WiFi network.

1. Open the Vestaboard app on your phone
2. Go to Settings > Local API
3. You'll see your API key and your board's IP address - save both of these

Cloud API

Use this if your board and computer are on different networks, or if Local API isn't available for your board.

1. Go to web.vestaboard.com and log in
2. Navigate to the API section
3. Enable the Read/Write API
4. Copy the API key and save it somewhere safe

Step 3: Get FiestaBoard Running

Choose the path that's easiest for you:

Path A: Docker Hub Pull (Simplest - no Git needed)

This is the fastest way. Open Terminal (Mac/Linux) or PowerShell (Windows):

On Mac: Press Cmd+Space, type "Terminal", press Enter. On Windows: Press the Windows key, type "PowerShell", press Enter.

Then paste these two commands one at a time:

curl -O https://raw.githubusercontent.com/Fiestaboard/FiestaBoard/main/docker-compose.hub.yml

docker-compose -f docker-compose.hub.yml up -d

Wait for it to finish downloading and starting (this takes 1-2 minutes the first time). When you see the terminal prompt again, FiestaBoard is running. Skip to Step 4.

Path B: Clone and Install Wizard

If you'd prefer to use the install wizard that guides you through setup:

git clone https://github.com/Fiestaboard/FiestaBoard.git
cd FiestaBoard

Then run the install wizard:

# Mac/Linux
./scripts/install.sh

# Windows (PowerShell)
.\scripts\install.ps1

The wizard will:

• Check that Docker is installed and running
• Ask for your board API key and device type
• Start the server
• Open the setup page in your browser

Path C: Download ZIP (No Git, No curl)

1. Go to github.com/Fiestaboard/FiestaBoard
2. Click the green Code button
3. Click Download ZIP
4. Extract the ZIP file to a folder you'll remember (like Documents)
5. Open Terminal/PowerShell and navigate to the extracted folder:

   cd ~/Documents/FiestaBoard    # Mac/Linux
   cd Documents\FiestaBoard      # Windows

6. Run the install wizard:

   ./scripts/install.sh           # Mac/Linux
   .\scripts\install.ps1          # Windows

Step 4: Open FiestaBoard

1. Open your web browser (Chrome, Firefox, Safari, Edge - any will work)
2. Go to http://localhost:4420
3. You should see the FiestaBoard dashboard

Accessing from a phone or another computer?

FiestaBoard automatically advertises itself on your local network. Try http://fiestaboard.local:4420 from any device on the same WiFi. If that doesn't work, use the IP address of the computer running FiestaBoard (e.g. http://192.168.1.50:4420).

Don't see anything?

If the page doesn't load, wait 30 seconds and try again - the server may still be starting up. Make sure Docker Desktop is running (look for the whale icon in your system tray or menu bar).

Step 5: Connect Your Board

If you used the install wizard (Path B or C), you may have already entered your API key. If not:

1. In the FiestaBoard dashboard, go to Settings
2. Enter your board API key (from Step 2)
3. If you're using the Local API, also enter your board's IP address (settings save automatically)

Step 6: Verify the Service is Running

1. Go to the main dashboard at http://localhost:4420
2. The display service starts automatically — verify the status shows Running
3. Your board should start updating within a few seconds

Congratulations - your board is now controlled by FiestaBoard!

Step 7: Make It Yours

Now the fun part. Here's what to do next:

Enable some plugins

1. Go to the Integrations page
2. Toggle on plugins you're interested in
3. Plugins that need API keys will show you where to get them

Start with these (no API key needed):

• Date & Time
• Star Trek Quotes
• Guest WiFi
• Visual Clock
• Sun Art
• Disney Parks
• Surf Conditions

Create your first page

1. Go to the Pages section
2. Click New
3. Use the visual editor to type what you want on the board
4. Use the Variables button to insert live data (like {weather.temperature} or {date_time.datetime})
5. Click Save

Set it as active

1. Select your new page from the Pages list
2. Click to make it the active page
3. Your board will update within a minute

For a more detailed walkthrough of these features, see Your First 10 Minutes.

Stopping and Starting FiestaBoard

To stop

Go back to your Terminal/PowerShell and type:

docker-compose down

To start again later

Open Terminal/PowerShell, navigate to the FiestaBoard folder (if applicable), and type:

docker-compose up -d

Then go to http://localhost:4420 — the service starts automatically.

tip

If you used Path A (Docker Hub pull), make sure you're in the folder where the docker-compose.hub.yml file is, and use:

docker-compose -f docker-compose.hub.yml up -d

Common Issues

"Docker is not running"

Make sure Docker Desktop is open. Look for the whale icon in your menu bar (Mac) or system tray (Windows). On Linux, run sudo systemctl start docker.

Page won't load at http://localhost:4420

• Wait 30-60 seconds after starting - the server needs time to initialize
• Make sure Docker containers are running: type docker ps in Terminal/PowerShell
• Make sure nothing else is using port 4420

Board not updating

1. Check that the service shows Running on the dashboard
2. Verify your board API key is correct (go to Settings)
3. For Local API: make sure your board and computer are on the same WiFi network
4. Check the logs: docker-compose logs -f

Still stuck?

• Check the full Troubleshooting Guide
• Ask in the Discord community
• Open an issue on GitHub

Next Steps

• Your First 10 Minutes - Detailed walkthrough of creating pages, enabling plugins, and scheduling
• Plugins Overview - See all 23 available plugins
• Schedule Mode - Automate when different pages display
• Quick Start - Condensed reference for experienced users