Skip to content

homepage

Homepage is a simple personal homepage app.

homepage

Prepare

podman pull ghcr.io/gethomepage/homepage:latest
mkdir -p $HOME/apps/{variables,container_data}
touch $HOME/apps/variables/homepage.env
mkdir -p $HOME/apps/container_data/homepage

Edit environment file

Edit the environment file and paste your default values for this service:

nano $HOME/apps/variables/homepage.env

Example contents:

HOMEPAGE_ALLOWED_HOSTS=www.skynet.lan
PUID=1000
PGID=1000
TZ=Europe/Athens

Installation

touch $HOME/.config/containers/systemd/homepage.container

# homepage.container
[Container]
ContainerName=homepage
HostName=homepage
AutoUpdate=registry
Image=ghcr.io/gethomepage/homepage:latest
Network=skynet.network
EnvironmentFile=%h/apps/variables/homepage.env
Volume=%h/apps/container_data/homepage:/app/config
#linuxserver.io specific
UIDMap=1000:0:1
UIDMap=0:1:1000
UIDMap=1001:1001:64536
[Service]
Restart=always
TimeoutStartSec=300
[Install]
WantedBy=default.target

Configuration of Nginx (Reverse Proxy)

Create nginx conf.

touch /$HOME/apps/container_data/nginx/homepage.conf

Configuration for nginx conf for port 80.

server {
  listen 80;
  server_name www.skynet.lan;

  access_log /var/log/nginx/homepage_access.log;
  error_log /var/log/nginx/homepage_error.log;

  location / {
    proxy_pass http://homepage:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

Restart Nginx

systemctl --user restart nginx

Usage

Open http://www.skynet.lan

Troubleshooting

podman logs -f homepage
journalctl --user -u nginx -n 200