Homepage v2.2.0: The Dashboard for Self-Hosted
Explore Homepage v2.2.0, the ultimate central dashboard for self-hosted services, featuring live Docker status and YAML configuration.
Stock photo for illustration only, not from the actual event
- Homepage v2.2.0 is a central dashboard to link all your self-hosted services in one start page.
- Fully configured through simple YAML files with no database and a tiny footprint.
- Killer feature reads the Docker socket to show live container running status.
- Version 2 introduces a built-in login system for secure web access.
The more services you self-host, the more IP addresses and bookmarks you have to manage. A dedicated dashboard solves this by providing a single start page that connects all your services, displays system loads, and indicates which containers are active. One of the nicest and fastest tools for this job is Homepage version 2.2.0, running behind Traefik and configured entirely through lightweight YAML files.
Setting up this central dashboard begins by creating the necessary folder structure for configuration files and icons using terminal commands. Next, you configure config/settings.yaml to control the visual appearance and layout, defining two separate groups categorized under Infrastructure and Media in a row layout with three columns each, which must match the service configuration precisely.
Stock photo for illustration only, not from the actual event
The heart of the setup lies in config/services.yaml, where individual tiles are created for each service by specifying a name, URL, description, and icon pulled from a built-in catalog. This allows you to link already-installed applications such as Nextcloud, Vaultwarden, Immich, and Jellyfin into one centralized hub for easy access.
Utilizing a static dashboard like Homepage streamlines home server monitoring without the overhead of heavy databases. By avoiding database dependencies, the application remains exceptionally fast and lightweight, making it ideal for deployment on resource-constrained hardware such as single-board computers or minimal virtual private servers.
Managing the top information bar is handled via config/widgets.yaml, which displays hardware resource utilization including CPU, RAM, and disk space, alongside a DuckDuckGo search box and formatted date and time elements. Homepage reads host resource metrics directly from within the container environment without requiring the Docker socket for basic stats.
The standout feature of Homepage is its ability to read directly from the Docker socket to verify if a container is operational and display per-container resource consumption. By creating a config/docker.yaml file and mounting the socket in read-only mode, the dashboard displays green status badges as soon as containers start up, while maintaining security against root-level vulnerabilities.
Finally, version 2 adds a native login system to secure the dashboard when exposed to the web. Administrators generate a secure session signing secret of at least 32 characters in an .env file alongside the deployment configuration, ensuring unauthorized external users cannot access administrative views.
Source: Dev.to
Found something wrong in this article? Report an issue with this article
Comments
Leave a Comment