Skip to content

daemonless/homepage

Repository files navigation

Homepage

A modern, highly customizable dashboard for your homelab.

Port 3000
Registry ghcr.io/daemonless/homepage
Docs daemonless.io/images/homepage
Source https://github.com/gethomepage/homepage
Website https://gethomepage.dev/

Deployment

Podman Compose

services:
  homepage:
    image: ghcr.io/daemonless/homepage:latest
    container_name: homepage
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - /path/to/containers/homepage:/config
    ports:
      - 3000:3000
    restart: unless-stopped

Podman CLI

podman run -d --name homepage \
  -p 3000:3000 \
  -e PUID=@PUID@ \
  -e PGID=@PGID@ \
  -e TZ=@TZ@ \
  -v /path/to/containers/homepage:/config \
  ghcr.io/daemonless/homepage:latest

Access at: http://localhost:3000

Ansible

- name: Deploy homepage
  containers.podman.podman_container:
    name: homepage
    image: ghcr.io/daemonless/homepage:latest
    state: started
    restart_policy: always
    env:
      PUID: "@PUID@"
      PGID: "@PGID@"
      TZ: "@TZ@"
    ports:
      - "3000:3000"
    volumes:
      - "/path/to/containers/homepage:/config"

Configuration

Environment Variables

Variable Default Description
PUID 1000 User ID for the application process
PGID 1000 Group ID for the application process
TZ UTC Timezone for the container

Volumes

Path Description
/config Configuration directory (settings, bookmarks, services)

Ports

Port Protocol Description
3000 TCP Web UI

Notes

  • Architectures: amd64
  • User: bsd (UID/GID set via PUID/PGID)
  • Base: Built on ghcr.io/daemonless/base (FreeBSD)

Releases

No releases published

Packages

 
 
 

Contributors