0xN1nja

0xN1nja / homepagectl

Public

Generate gethomepage.dev configs from running Docker containers

23
0
100% credibility
Found Mar 29, 2026 at 23 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

This tool scans your running apps on the server, recognizes popular services like media players and monitors, and automatically creates ready-to-use dashboard files with links, icons, groups, and settings.

How It Works

1
🔍 Discover homepagectl

You're tired of hand-editing your home dashboard setup every time you add a new app, and you find this handy tool that automates it all.

2
📥 Install the tool

Follow a few simple steps to download and prepare the tool on your computer so it's ready to use.

3
⚙️ Share your preferences

Create a quick note telling the tool your server's address, dashboard colors, layout styles, and which apps to skip.

4
👀 Preview detections

Check a list of your running apps, seeing their names, icons, ports, and suggested groups – everything looks perfect.

5
✨ Create dashboard setup

Run the magic command to automatically generate your dashboard files, complete with links, icons, and placeholders for logins.

🎉 Launch your dashboard

Open your homepage in the browser and enjoy seeing all your services beautifully organized, connected, and status-checked.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 23 to 23 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is homepagectl?

homepagectl is a Go CLI tool that scans running Docker containers via the socket to generate gethomepage.dev configs automatically. It detects ports, matches services like Jellyfin or Portainer to widgets, and outputs services.yaml, settings.yaml, and .env files based on a simple toml config. Say goodbye to hand-crafting YAML for every new container spin-up.

Why is it gaining traction?

It auto-recognizes dozens of popular apps from media stacks (Sonarr, Plex) to monitoring (Grafana, Uptime Kuma), respects container labels for overrides, and merges safely with existing files without clobbering them. Commands like `list` preview detections and `generate --dry-run` let you inspect before committing, making it a quick win for dynamic Docker setups over manual editing.

Who should use this?

Homelab operators running gethomepage.dev with 10+ Docker services, like media hoarders juggling Radarr/Lidarr or self-hosters with Portainer and Traefik. Ideal for folks frequently adding containers who want dashboard updates without YAML fiddling. Skip if your setup is static or label-free.

Verdict

Solid niche tool for Docker-to-gethomepage.dev config generation; install via make and tweak homepagectl.toml to start. At 23 stars and 1.0% credibility score, it's early-stage with good README but unproven scale—dry-run everything and contribute if it clicks.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.