Hubleys
Personal dashboards to organize links for multiple users via a central yaml config.
Alternatives
Tech stack
No tech stack added yet. Sign in to suggest some
Introduction
Hubleys (subtitled "Brave New Dashboard") is an open-source, self-hosted dashboard. If you run a collection of self-hosted services for multiple users and don't want to send out links one by one, you can use Hubleys to generate a dedicated dashboard for each user. Administrators define the dashboard content in one central place, and what each user can see is determined by their user group and permissions.
The project is built with SvelteKit and Tailwind CSS, and is licensed under the MIT license.
Key Features
- Per-user dashboards: Shows different content to each person based on user and user group permissions
- Centralized admin configuration: All dashboard content is predefined by the administrator in
config.yml - Link tiles: Organize service links into folders
- Search engine: Supports autocomplete
- Calendar: Shows upcoming calendar events
- Notifications: Administrators can display messages to users
- Backgrounds: Customizable, with support for dynamic backgrounds, including Unsplash images, local wallpaper collections, and user-uploaded images
- Weather: Shows current weather and forecasts via OpenWeatherMap
- Widgets: Clock, stopwatch, and timer
Target Users
- Administrators who provide multiple self-hosted services for family, friends, or teams
- Homelab users who already use an authentication solution such as Authelia
- Small organizations that need to control which services are visible by user group
Deployment
Quick Try
docker run -it --rm -e SINGLE_USER_MODE=1 -e ORIGIN=http://localhost:3000 -p127.0.0.1:3000:3000 ghcr.io/knrdl/hubleys-dashboard:edge
In demo mode, the weather and Unsplash background features are unavailable.
Docker Compose
services:
hubleys:
image: ghcr.io/knrdl/hubleys-dashboard
restart: unless-stopped
environment:
OPENWEATHERMAP_API_KEY: xxx
UNSPLASH_API_KEY: xxx
ADMINS: user:user1, user:user2, group:admins
volumes:
- ./data:/data
mem_limit: 100m
- All persistent data is stored in the
/datadirectory. The directory structure is generated automatically on first start, includingconfig.yml,logos/,wallpaper/, and user configurations. - On the host, you need to run
chown -R 1000:1000 ./datafirst to fix the directory permissions. - After changing the configuration, you can restart the container, or apply the changes via "Settings → Administration → Reload app".
Reverse Proxy and Authentication
Hubleys uses Forward Auth and reads user information from HTTP request headers:
Remote-User: Unique user ID, requiredRemote-Groups: Groups the user belongs to, comma-separatedRemote-Name: Display name, optionalRemote-Email: Email address, optional
Example configurations are provided officially for Caddy + Authelia and Nginx + Authelia.
Technical Requirements
- A Docker environment; the official example sets a memory limit of 100MB
- A reverse proxy that supports Forward Auth, plus an authentication provider (such as Authelia)
- Optional: an OpenWeatherMap API key (for weather) and an Unsplash API key (for background images), both of which can be obtained for free
Notable Characteristics
- It does not handle login itself; authentication is left entirely to an external authentication provider, making it easy to integrate with an existing single sign-on (SSO) setup
- Dashboard content is configured in YAML files, which can be managed separately in a Git repository
- It ships with a set of default icons, and can also reference icon libraries such as selfh.st/icons, dashboard-icons, and Simple Icons, or use image URLs directly
- Administrators can edit
default-config.jsonto preset default settings for new users
Discover more
Dashy
Feature-rich homepage for your homelab, with easy YAML configuration.
Hiccup
Beautiful static homepage to get to your links and services quickly. It has built-in search, editing, PWA support and localstorage caching to easily organize your start page.
Jump
Yet another startpage for your server designed to be simple, stylish, fast and secure.
Mafl
Minimalistic flexible homepage.
Personal Management System
Your web application for managing personal data.
Starbase 80
A simple homepage with an iPad-style application grid, for mobile and desktop. One JSON configuration file.