AirCast Setup Guide

Flash our pre-configured Pi image, connect to the hotspot, bind your device. Done.

~20 minutes — Flash (5 min) + Boot (3 min) + Bind (2 min) + Verify (10 min)

Download

Based on Raspberry Pi OS Lite (64-bit). Works with Pi 3, 4, 5, and Zero 2 W.

Latest Development Release

Version v1.2.4-dev.88Latest features, may be unstable

Dev

Raspberry Pi Image

Compatible with: Raspberry Pi 3, 4, 5, and Zero 2 W (64-bit ARM)

Installation Steps

1

Flash the Image

~5 min

Option A: Raspberry Pi Imager

  1. Download Raspberry Pi Imager
  2. Click "Choose OS" → "Use custom"
  3. Select the downloaded image file
  4. Click "Choose Storage" → Select SD card
  5. Click "Write" and wait

Option B: balenaEtcher

  1. Download balenaEtcher
  2. Click "Flash from file"
  3. Select the downloaded image
  4. Select target → Your SD card
  5. Click "Flash!" and wait
2

Boot and Connect

~3 min
  1. Insert the SD card into your Raspberry Pi
  2. Power on and wait 2–3 minutes for first boot
  3. Connect to the WiFi hotspot from your phone or laptop:

    Network: AircastDevice

    Password: 123456789

3

Bind Your Device

~2 min
  1. Open a browser and go to http://aircast.local
  2. Click "Bind Device Now"
  3. Click "Open AirCast Login" — sign in or create your account
  4. Enter the device code shown on the binding page
  5. The device connects automatically once authorized

What Success Looks Like

After completing setup, you should see:

  • Your device appears as "Online" in the AirCast dashboard
  • Live video feed visible in the web app
  • Telemetry data (altitude, GPS, battery) if flight controller is connected
  • Share the stream link with your team for simultaneous viewing
AirCast dashboard showing a device online with Connect button

Compatible Devices

Fully supported: Raspberry Pi 5, Pi 4 Model B, Pi 400, Pi 3 Model B/B+, Pi Zero 2 W

Requirements: 8GB+ SD card, 4G/LTE modem or WiFi, USB or CSI camera, 5V power supply (BEC/regulator for drone mounting)

Need hardware? See our Recommended Starter Kit ($95–$180)

Configuration

SSH is enabled by default:

ssh pi@aircast.local

Default password: raspberry change it immediately with passwd

The WiFi hotspot (AircastDevice / 123456789) stays active after setup for maintenance access. See SSH Access Guide for more details.

Troubleshooting

  • Can't access aircast.local? Use http://192.168.4.1 instead.
  • No video stream? Check camera connection and enable it with raspi-config.
  • No telemetry? Verify flight controller connection and MAVLink baud rate.
  • Poor quality / disconnections? Check 4G signal strength. Try an external antenna.

Advanced Usage

Build Your Own Image:View the pi-gen build configuration

The AirCast Pi image is built using the official Raspberry Pi OS build tools. You can customize and build your own version.

AirCast Setup Guide | Pre-configured Pi Image | AirCast