A Customizable Homepage for Your Homelab and Services**

If you're running a homelab, self-hosting services, or just have a bunch of web interfaces to keep track of, you know the struggle. Bookmarks get messy, and remembering all those different ports and addresses is a pain. What if you had a single, clean dashboard to rule them all?

That's the idea behind Homepage. It's a sleek, highly customizable start page that you can host yourself. It brings all your services, tools, and information feeds into one place, and it's designed from the ground up to be extended.

What It Does In a nutshell, Homepage is a self-hosted web application that acts as a central dashboard for your digital life. You configure it with YAML files, defining sections for your services, bookmarks, and information widgets. Once it's running, you get a single, clean interface that provides quick access to everything you need, from your Proxmox server and Docker containers to your favorite developer documentation sites.

Why It's Cool The real power of Homepage comes from its integrations and its simplicity.

• Docker Integration: This is a killer feature. Homepage can automatically discover your running Docker containers and display their status. No more manually updating links when you spin up a new container.
• Service API Integrations: It goes beyond static links. You can embed widgets that show live data from various services. Think of seeing your Pi-hole stats, Sonarr queue, or system resource usage right on the homepage.
• It's Just YAML: The configuration is entirely file-based (YAML), making it easy to version control your setup with Git. If you mess something up, you can just revert your changes.
• Highly Themable: Don't like the default look? You can tweak the CSS to match your vibe. It's your homepage, so it should look how you want.

How to Try It The easiest way to get started is with Docker. The project's README is excellent, but here's the gist of it.

1. Create a docker-compose.yml file:

   version: '3.3'
   services:
     homepage:
       image: ghcr.io/gethomepage/homepage:latest
       container_name: homepage
       ports:
         - 3000:3000
       volumes:
         - /path/to/your/config:/app/config # Mount your config directory
         - /var/run/docker.sock:/var/run/docker.sock # For Docker integration
       restart: unless-stopped
   

2. Create your configuration files in the mounted directory. Start with a basic services.yaml to define your links.
3. Run docker-compose up -d and open http://your-server:3000.

Check out the Homepage GitHub repository for detailed setup guides and a full list of configuration options and integrations.

Final Thoughts As someone who's constantly juggling multiple services, a tool like Homepage is a game-changer for organization. It turns a collection of disparate tabs into a functional, personalized command center. It's one of those projects that feels simple but ends up saving you a surprising amount of time and mental energy. If you've got more than a handful of self-hosted services, it's absolutely worth a weekend to set up.

@githubprojects