Installation
Choose your installation method based on your hardware and preferences. All methods use pre-built packages from GitHub Releases .
Choose Your Method
Flash a ready-to-go SD card image — everything pre-installed. Configure WiFi from your phone via captive portal.
Raspberry Pi ImageOne-liner scripts for any Linux device. Install the server, display app, or both.
Install ScriptDeploy the server as a Docker container — no system-level dependencies.
DockerPlatform-specific reference for flutter-pi, eLinux, Linux desktop, and Android display setups.
Display PlatformsWhich Method Is Right for You?
| Method | Best For | Platforms |
|---|---|---|
| Raspberry Pi Image | Zero-config Raspberry Pi setup | Pi 3B+, 4, 5, Zero 2W (64-bit) |
| Install Script | Any Linux — server, display, or both | Any Linux with systemd (Debian, Ubuntu, Fedora, etc.) |
| Docker | Containerized server deployment | Any Linux host with Docker |
| Display Platforms | Adding displays to an existing server | Raspberry Pi, Linux x64, Android |
Raspberry Pi? The pre-built image is the fastest path — flash, boot, configure WiFi from your phone.
Other Linux? Use the install script — one command for the server, one for the display.
Multiple displays? Install the server first (image, script, or Docker), then add displays using the install script or display platforms guide on each display device.
System Requirements
Server (Backend + Admin)
- OS: Linux with systemd (Raspberry Pi OS, Debian, Ubuntu, Fedora, etc.)
- Node.js: Version 24 or higher (install scripts handle this automatically)
- Architecture: ARM (32-bit), ARM64 (64-bit), or x64
- RAM: 512 MB minimum, 1 GB recommended
- Storage: 300 MB free space minimum
Display (Panel App)
- Raspberry Pi: flutter-pi runtime (no desktop environment needed)
- Linux x64: eLinux DRM-GBM mode (no desktop required) or Linux desktop with GTK3
- Android: Android 7.0+ (sideloaded via ADB or APK)
What’s Next?
Choose your installation method above and follow the guide. After installation, proceed to Onboarding to create your admin account and start configuring your smart panel.