Skip to content

Quickstart

Flash your first board in 5 minutes.

Using the Web UI

  1. Sign up at flashbay.dev — you get 20 free credits, sessions up to 10 minutes
  2. Go to Dashboard and click Start Session on an available board
  3. Upload firmware — click the flash button and select your .bin file
  4. Watch it flash — progress streams in real-time
  5. Use the terminal — the serial console connects automatically after flashing

Using the CLI

Install the CLI:

bash
# macOS / Linux
curl -fsSL https://flashbay.dev/install.sh | sh

# or with Go
go install github.com/flashbay-dev/fbay-cli@latest

Set your API key:

bash
export FLASHBAY_API_KEY=key_...

Start a session, flash, and connect:

bash
# Reserve an ESP32-S3 board
fbay session create --board esp32-s3

# Flash firmware to it
fbay flash firmware.bin

# Open serial console
fbay serial

# Done? End the session to stop credit usage
fbay session end

Using the Python SDK

bash
pip install flashbay
python
import flashbay

client = flashbay.Client()

# Start a session, flash, and interact
with client.session(board="esp32-s3") as session:
    session.flash("firmware.bin")
    session.serial.expect("Ready")
    session.serial.send("status\n")
    output = session.serial.read_until("OK", timeout=5)
    print(output)

Next steps