Homepage

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

Replaces

Paid start page services, such as Start.me.

All open-source alternatives to Start.me

Difficulty

Difficulty: Easy

1 service, 2 volume mounts, no env values to set, host access: docker_socket. Heuristic score 2 of 11: easy.

Stack

JavaScript (language)

Deployment

docker_compose

Requirements

Not stated.

License

GPL-3.0 (OSI-approved open source)

Read from github.com/gethomepage/homepage/blob/44bf8c1/LICENSE

Business model

Unknown

The README at the pinned commit does not state a business model, so it stays unknown.

Source: github.com/gethomepage/homepage/blob/44bf8c1/README.md, read on 2026-10-22.

Repository

gethomepage/homepage

GitHub stats

Stars: 33,285
Forks: 2,152
Open issues and pull requests: 1
Last push: 2026-10-22
Latest release: v2.6.0
Released: 2026-10-17

From the GitHub API on 2026-10-22. These numbers are a snapshot, not live. GitHub detected the license as GPL-3.0.

Compose file

Config check passed docker compose config exited 0 on this exact file on 2026-10-22.

docker.md Version 1

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

From the app's own repository: github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md.

Compose example from the project's own docs: gethomepage/homepage:docs/installation/docker.md.

Install

Docker with the Compose plugin (github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md#L8-L20)
A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
Save the code block as docker-compose.yml (github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md)
Use the compose file shown above.
What the compose file check ran with (github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md#L8-L20)
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.
Start it (github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md)
```
docker compose up -d
```
Open the app (github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md)
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. (github.com/gethomepage/homepage/blob/44bf8c1/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. (github.com/gethomepage/homepage/blob/44bf8c1/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). (github.com/gethomepage/homepage/blob/44bf8c1/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. (github.com/gethomepage/homepage/blob/44bf8c1/docs/installation/docker.md, checked 2026-10-22)

Signals

Open issues and pull requests: 1
Last push: 2026-10-22 (0 days before this page was built)
Latest release: v2.6.0 on 2026-10-17 (5 days before this page was built)