> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Homepage

# 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/](https://gethomepage.dev/)

### Adding a New Service

1. Add the service entry to `config/services.yaml`
2. Add any required API keys to `.env` with `HOMEPAGE_VAR_` prefix
3. 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

```bash theme={null}
docker exec homepage wget -qO- http://jellyfin:8096/health
```