Repolode
Turbootzz

Turbootzz/Nimbus

A self-hosted homelab dashboard with multi-user accounts, real-time health checks of your services, themes, and Prometheus metrics.

Stars
134
Forks
4
Open issues
30
Last commit
7 days ago

What is it?

Nimbus is a self-hosted dashboard for organizing and monitoring the services in a homelab. Each user gets their own account with JWT login, OAuth2 sign-in via Google, GitHub or Discord, and role-based access control, and an admin panel handles user management.

Services appear as draggable tiles that are checked in real time, with response time tracking, status history and uptime graphs. Personalization covers per-user wallpapers, light and dark modes, accent colors, and a canvas layout with a top bar. Metrics can be exported to Prometheus.

The 2.0 development image adds widgets such as clock, notes, RSS, weather, system stats and Docker containers, along with integrations that show live numbers from apps like Pi-hole, Jellyfin, Sonarr and Home Assistant. It deploys with Docker Compose, with secrets generated on first run.

Key features

  • 01Local accounts and OAuth2 sign-in with Google, GitHub or Discord
  • 02Role-based access control with an admin panel
  • 03Real-time health checks with response time and uptime history
  • 04Per-user wallpapers, light/dark mode and accent colors
  • 05Prometheus metrics export
  • 06Widgets and app integrations in the 2.0 dev image

Use cases

  • Building a single start page for all self-hosted services in a homelab
  • Monitoring which services are up and how fast they respond
  • Sharing a dashboard with family members or a small team, each with their own login
  • Showing live stats from Pi-hole, Jellyfin or Home Assistant next to service tiles

Quick start

  1. 1

    Create the docker-compose.yml file by downloading it from the repository

    mkdir nimbus && cd nimbus curl -O https://raw.githubusercontent.com/Turbootzz/Nimbus/main/docker-compose.yml
  2. 2

    Start Nimbus with Docker Compose

    docker-compose up -d
  3. 3

    Open http://localhost:3000 in your browser and create your first account

Things to know

  • Licensed under AGPL v3, a copyleft license that requires sharing modifications when offered as a network service.
  • Requires PostgreSQL, so self-hosting involves running a database alongside the app.
  • Some widget and integration features are on the dev branch and may break at any time.

In collections

Topics

FAQ

What is Nimbus?
A self-hosted homelab dashboard with multi-user accounts, real-time health checks of your services, themes, and Prometheus metrics. Nimbus is a self-hosted dashboard for organizing and monitoring the services in a homelab. Each user gets their own account with JWT login, OAuth2 sign-in via Google, GitHub or Discord, and role-based access control, and an admin panel handles user management.
Is Nimbus free to use? What license does it have?
Nimbus is open source under the Other license. Check the license terms before using it in commercial products.
Is Nimbus still maintained?
Actively maintained. The last commit to Nimbus was on Oct 31, 2026.
What can I use Nimbus for?
Building a single start page for all self-hosted services in a homelab Monitoring which services are up and how fast they respond Sharing a dashboard with family members or a small team, each with their own login Showing live stats from Pi-hole, Jellyfin or Home Assistant next to service tiles
How do I install Nimbus?
Create the docker-compose.yml file by downloading it from the repository: mkdir nimbus && cd nimbus curl -O https://raw.githubusercontent.com/Turbootzz/Nimbus/main/docker-compose.yml Start Nimbus with Docker Compose: docker-compose up -d Open http://localhost:3000 in your browser and create your first account
Where can I get Nimbus?
The source code and installation instructions are on GitHub: https://github.com/Turbootzz/Nimbus

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects