A FastAPI-based dashboard for monitoring on a Raspberry Pi.

• Prerequisites
• Quick Start
  • Installation
  • Configuration
  • Managing the Container
• License

• Docker and Docker Compose installed
• Linux system

Download the latest release from GitHub Releases.

Rename .env.example to .env and edit it to configure the server.

• HOST: Server host address (default: localhost)
• PORT: Server port (default: 443)
• API_TOKEN_HASH: Leave blank to auto-generate on first run, or provide your own token hash

# Start the container
docker compose up -d

# Stop the container
docker compose down

# Update to the latest version
docker compose pull && docker compose up -d

# View the logs
docker compose logs -f pi-dashboard

Note: You may need to add your user to the Docker group and log out/in for permission changes to take effect:

sudo usermod -aG docker ${USER}

This project is licensed under the MIT License - see the LICENSE file for details.