selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

miniboard logo

Self-host miniboard

1.2.2

Lightweight dashboard with uptime monitoring and tabs

ReleaseOpen SourceMIT
Updated2 years ago
LanguageGo
Setup difficultyEasy
ThemeDark mode
Stars
242
Port
8849 (Web GUI)
Docker
aceberg/miniboard
Install with Docker Compose
Main dashboard view with tabs and panelsAvailable Bootswatch themes

What is miniboard?

miniboard is a lightweight self-hosted dashboard written in Go that lets you organize services into tabs and panels with uptime monitoring. It supports configuring panels and hosts through a web GUI or YAML files, offers Bootswatch themes with light/dark modes, and can send notifications via Shoutrrr (e.g., Gotify) when host status changes. The app runs as a single binary or Docker container on port 8849, uses SQLite for uptime history, and optionally mounts the Docker socket to auto-discover containers. Authentication is available via session cookies with bcrypt password hashing. Last release was 1.2.2 in December 2023; the project appears inactive since then.

miniboard alternatives

Should you self-host miniboard?

miniboard scores 45/100 on selfhost.directory (how scoring works) and ranks #29 of 44 in Dashboard. It has 242 GitHub stars, +1 in the last 30 days.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Homepage by gethomepage (84/100, 33 448 stars). It scores higher overall, so compare the two before you pick. See miniboard vs Homepage by gethomepage side by side.

Features

  • Notifications
  • Offline ModeRequires separate node-bootstrap container
  • Session Authentication
  • Tabbed dashboard
  • Uptime Monitoring
  • Web GUI configuration
  • YAML Configuration

miniboard README

How to install miniboard

Install miniboard with Docker Compose

Docker Engine, Docker Compose

version: "3" services: miniboard: image: aceberg/miniboard restart: unless-stopped ports: - 8849:8849 volumes: - ~/.dockerdata/miniboard:/data/miniboard - /var/run/docker.sock:/var/run/docker.sock environment: TZ: Asia/Novosibirsk HOST: "0.0.0.0" PORT: "8849" THEME: "flatly" COLOR: "dark"

Use docker-compose-local.yml for offline mode with node-bootstrap

How to configure miniboard

  • AUTHfalseEnable Session-Cookie authentication

    values: true, false

  • AUTH_EXPIRE7dSession expiration time. A number and suffix: m, h, d or M.

    values: e.g. 7d, 24h, 30m

  • AUTH_USERUsername

    values: string

  • AUTH_PASSWORDEncrypted password (bcrypt)

    values: bcrypt hash

  • HOST0.0.0.0Listen address

    values: IP address

miniboard releases & version history

More in Dashboard

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…