Back to services

Hubleys

Personal dashboards to organize links for multiple users via a central yaml config.

View alternatives to Hubleys
Suggest edit
Open source
Self-hostable
MIT
Recent reviews

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 /data directory. The directory structure is generated automatically on first start, including config.yml, logos/, wallpaper/, and user configurations.
  • On the host, you need to run chown -R 1000:1000 ./data first 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, required
  • Remote-Groups: Groups the user belongs to, comma-separated
  • Remote-Name: Display name, optional
  • Remote-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.json to preset default settings for new users