Uptime Kuma Deployment Overview on Server¶

FQDN of the final panel on hostkey.in domain¶

File and Directory Structure¶

The system uses the following directories to store configurations and data:

• /opt/uptime-kuma/data — Uptime Kuma application data storage.

• /root/nginx — Nginx working directory (contains compose.yml).

• /data/nginx/user_conf.d — Custom Nginx configurations.

• /data/nginx/nginx-certbot.env — Environment variables file for Nginx Certbot.

Application Installation Process¶

The application is deployed in a Docker container using the louislam/uptime-kuma:1 image. The installation includes configuring an Nginx reverse proxy with automatic SSL certificate acquisition via Certbot.

Docker Containers and Execution¶

Uptime Kuma¶

Application container running in host mode to ensure network accessibility.

• Image Name: louislam/uptime-kuma:1

• Ports: 3000 (internal)

• Volumes: /opt/uptime-kuma/data:/app/data

• Environment Variables: UPTIME_KUMA_PORT=3000

• Restart Policy: always

Nginx Certbot¶

Proxy server container to provide HTTPS access.

• Image Name: jonasal/nginx-certbot:latest

• Ports: runs in host mode (proxies traffic to port 443)

• Volumes:

  • nginx_secrets:/etc/letsencrypt (external volume with certificates)

  • /data/nginx/user_conf.d:/etc/nginx/user_conf.d

• Environment Variables: [email protected]

• Restart Policy: unless-stopped

Application Update¶

Updates are performed via pull and container restart:

docker compose -f /root/nginx/compose.yml pull && docker compose -f /root/nginx/compose.yml up -d

Permissions Settings¶

The following access permissions are set for the directories:

• /root/nginx: owner root, group root, mode 0755.

• Configuration files in /root/nginx/compose.yml: owner root, group root, mode 0644.

Location of Configuration Files and Data¶

Available Connection Ports¶

• 443 — HTTPS (via Nginx proxy)

• 3000 — HTTP (internal application port, accessible via host)