Skip to Content
🚀 We just launched! Please star us on Github!

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 bash

This 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 8080

Available 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-tailscale

A 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 install

See 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:3000

Replace 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 bash

Install the display app

curl -fsSL https://get.smart-panel.fastybird.com/display | sudo bash \ -s -- --backend http://localhost:3000 --kiosk

Both 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 influxdb

Smart 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/environment

Add:

FB_INFLUXDB_URL=http://localhost:8086 FB_INFLUXDB_DATABASE=smart_panel

Restart the service to apply:

sudo smart-panel-service restart

Post-Installation

Verify the Service

sudo smart-panel-service status

You 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:3000

Or 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 -f

Service 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 update

Configuration

Environment variables are stored in /etc/smart-panel/environment:

VariableDefaultDescription
FB_BACKEND_PORT3000HTTP server port
FB_TOKEN_SECRETAuto-generatedJWT authentication secret
FB_MDNS_ENABLEDtrueEnable mDNS discovery

Manual Installation (npm / tarball)

For advanced users who want full control over the installation process.

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 nodejs

Install Smart Panel

sudo npm install -g @fastybird/smart-panel

Configure and Start the Service

sudo smart-panel-service install

This 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
Last updated on