Install Script
Install Smart Panel on any Linux device with systemd using one-liner scripts. Works on Raspberry Pi, Debian, Ubuntu, Fedora, and other Linux distributions.
The install scripts handle everything automatically — installing dependencies, downloading packages, configuring systemd services, and running database migrations.
Prerequisites
- A Linux device with systemd (Raspberry Pi, Debian, Ubuntu, Fedora, etc.)
- Network connectivity (Wi-Fi or Ethernet)
- SSH access or a local terminal
Install the Server (Backend + Admin)
Run a single command to install the Smart Panel backend and admin interface:
curl -fsSL https://get.smart-panel.fastybird.com | sudo bashThis script will:
- Install Node.js if it is not already present
- Download the latest Smart Panel backend and admin package
- Configure a systemd service that starts automatically on boot
- Run database migrations
You can customize the installation with flags:
curl -fsSL https://get.smart-panel.fastybird.com | sudo bash -s -- --port 8080Available flags: --port <port>, --version <ver>, --beta, --alpha, --with-tailscale
Add --with-tailscale to also install Tailscale for remote access, left disabled
until you enable it from the admin UI:
curl -fsSL https://get.smart-panel.fastybird.com | sudo bash -s -- --with-tailscaleA Tailscale install failure is reported in the completion banner but never aborts the rest of the install. See Remote Access for the setup walkthrough.
Installed before privileged remote-access setup (Tailscale’s Set up step) existed? The sudoers grant it needs is added by the installer’s own setup step, so an installation that predates it is missing that grant. Re-run it once to pick it up — safe to repeat, and it won’t touch your existing data or configuration:
sudo smart-panel-service installSee Set up cannot run if Set up still refuses afterward.
Install the Display App
To add a display panel — on the same device or a different one — run:
curl -fsSL https://get.smart-panel.fastybird.com/display | sudo bash \
-s -- --backend http://YOUR_SERVER_IP:3000Replace YOUR_SERVER_IP with the IP address of your Smart Panel server.
The script auto-detects the platform (Raspberry Pi and ARM64 boards via flutter-pi, Linux x64 desktop, etc.) and installs the correct variant automatically.
Available flags:
--backend <url>— server URL (required)--kiosk— auto-start the display on boot--platform <type>— force a specific platform:flutterpi,linux
All-in-One (Server + Display)
To run both the server and the display app on a single device, execute both scripts in sequence:
Install the server
curl -fsSL https://get.smart-panel.fastybird.com | sudo bashInstall the display app
curl -fsSL https://get.smart-panel.fastybird.com/display | sudo bash \
-s -- --backend http://localhost:3000 --kioskBoth services will start automatically on boot. The --kiosk flag ensures the display launches
as soon as the device powers on.
Optional: Install InfluxDB
InfluxDB is optional. Without it, Smart Panel uses in-memory storage — device values and real-time updates work normally, but historical data (charts, timeseries) is not persisted across restarts.
To enable time-series data storage for temperature history, energy monitoring, and other charts, install InfluxDB v1.8:
wget -qO- https://repos.influxdata.com/influxdata-archive_compat.key | sudo tee /etc/apt/trusted.gpg.d/influxdata.asc
echo "deb https://repos.influxdata.com/debian bookworm stable" | sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt update
sudo apt install influxdb=1.8.10-1 -y
sudo systemctl enable influxdb
sudo systemctl start influxdbSmart Panel requires InfluxDB v1.8. InfluxDB 2.x is not compatible.
Then configure the connection in your Smart Panel environment:
sudo nano /etc/smart-panel/environmentAdd:
FB_INFLUXDB_URL=http://localhost:8086
FB_INFLUXDB_DATABASE=smart_panelRestart the service to apply:
sudo smart-panel-service restartPost-Installation
Verify the Service
sudo smart-panel-service statusYou should see the service running with its PID, uptime, and memory usage.
Access the Admin Interface
Open a browser and navigate to:
http://smart-panel.local:3000Or use the device’s IP address: http://<device-ip>:3000
The .local hostname requires mDNS support (enabled by default).
You can find the IP address by running hostname -I on the device.
View Logs
sudo smart-panel-service logs -fService Management
# Check status
sudo smart-panel-service status
# View logs
sudo smart-panel-service logs -f
# Restart
sudo smart-panel-service restart
# Update to latest version
sudo smart-panel-service updateConfiguration
Environment variables are stored in /etc/smart-panel/environment:
| Variable | Default | Description |
|---|---|---|
FB_BACKEND_PORT | 3000 | HTTP server port |
FB_TOKEN_SECRET | Auto-generated | JWT authentication secret |
FB_MDNS_ENABLED | true | Enable mDNS discovery |
Manual Installation (npm / tarball)
For advanced users who want full control over the installation process.
npm
Install via npm
Install Node.js
The backend requires Node.js 24 or higher:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejsInstall Smart Panel
sudo npm install -g @fastybird/smart-panelConfigure and Start the Service
sudo smart-panel-service installThis creates a dedicated system user, sets up data directories, creates configuration
at /etc/smart-panel/, and registers a systemd service.
What’s Next?
Your Smart Panel is installed and running.
- Add display panels by following the Display Platforms guide on your display devices
- Create your admin account by following the Onboarding guide