Homepage
Personal homepage dashboard.Configuration Files
| File | Purpose |
|---|---|
config/services.yaml | Service groups and widgets |
config/widgets.yaml | Top bar info widgets |
config/settings.yaml | Theme, layout, and global settings |
config/bookmarks.yaml | Quick links |
config/docker.yaml | Docker socket connection |
config/custom.css | Custom styling |
config/custom.js | Custom JavaScript |
Customization
Documentation: https://gethomepage.dev/Adding a New Service
- Add the service entry to
config/services.yaml - Add any required API keys to
.envwithHOMEPAGE_VAR_prefix - Redeploy:
docker compose -f homepage/compose.yaml up -d
Troubleshooting
- Widget showing error: Check API key is correct and service is reachable from the homepage container
- Docker stats not showing: Ensure docker.yaml has socket configured and container names match
- Service not connecting: Use internal Docker hostnames (container names) not external URLs