# Homepage

Start page for your services and widgets, configured with YAML files.

- Replaces: [Start.me](https://openlogs.fyi/alternatives/start-me)
- Summary: Paid start page services, such as Start.me.
- Stack: JavaScript (language)
- Deployment: docker_compose
- License: GPL-3.0 (osi) [source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/LICENSE)
- Business model: unknown. The README at the pinned commit does not state a business model, so it stays unknown. ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/README.md), read 2026-10-22)
- Difficulty: easy. 1 service, 2 volume mounts, no env values to set, host access: docker_socket. Heuristic score 2 of 11: easy.
- Requirements: not stated
- Repository: [gethomepage/homepage](https://github.com/gethomepage/homepage)

## Install

1. Docker with the Compose plugin ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md#L8-L20))

   ```text
   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
   ```

2. Save the code block as docker-compose.yml ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md))

   ```yaml
   services:
     homepage:
       image: ghcr.io/gethomepage/homepage:latest
       container_name: homepage
       ports:
         - 3000:3000
       volumes:
         - /path/to/config:/app/config # Make sure your local config directory exists
         - /var/run/docker.sock:/var/run/docker.sock:ro # (optional) For docker integrations
       environment:
         HOMEPAGE_ALLOWED_HOSTS: gethomepage.dev # required, may need port. See gethomepage.dev/installation/#homepage_allowed_hosts
   ```

3. What the compose file check ran with ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md#L8-L20))

   ```text
   This compose file is copied unchanged from the code block in https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md#L8-L20. The check ran on that block alone. The Docker installation guide shows this docker compose example.
   ```

4. Start it ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md))

   ```bash
   docker compose up -d
   ```

5. Open the app ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md))

   ```text
   Open http://localhost:3000. The compose file publishes host port 3000 for the homepage service.
   ```

Compose file check: config_ok on 2026-10-22.

## Gotchas and maintenance

### Gotchas

- Some images use the latest tag or no tag: Images without a pinned version: homepage: ghcr.io/gethomepage/homepage:latest. A later pull can get a different version. ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md), checked 2026-10-22)
- The compose file publishes host ports: Host ports: 3000 (homepage). A port without a host address listens on all host network interfaces. ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md), checked 2026-10-22)
- The compose file mounts host folders: Host paths mounted into containers: /path/to/config at /app/config (homepage). ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md), checked 2026-10-22)
- Some services get elevated host access: homepage mounts the Docker socket, which gives it control of Docker on the host. ([source](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 1
- Stars: 33285, forks: 2152
- Last push: 2026-10-22 (0 days ago)
- Latest release: v2.6.0 on 2026-10-17 (5 days ago)

## Sources

- [Repository: https://github.com/gethomepage/homepage](https://github.com/gethomepage/homepage)
- [License: https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/LICENSE](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/LICENSE)
- [Business model: https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/README.md](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/README.md)
- [Compose file: https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md)
- [Install step: https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md#L8-L20](https://github.com/gethomepage/homepage/blob/44bf8c196232592049d99275f7c58718d167e9e4/docs/installation/docker.md#L8-L20)

---
Canonical: https://openlogs.fyi/tools/homepage  
Last updated: 2026-10-22