Uptime Kuma

Description / name	Input element
Container Registry
Container Configuration Root Path
Timezone
User ID
Group ID
Uptime Kuma Host Port
Uptime Kuma /config Path

Self-hosted uptime monitoring tool with a beautiful dashboard, status pages, and multi-channel notifications.


Port	`3001`
Registry	`ghcr.io/daemonless/uptime-kuma`
Daemonless	daemonless/uptime-kuma
Source	louislam/uptime-kuma
Website	uptime.kuma.pet

Version Tags

Tag	Description	Best For
`latest`	Upstream Binary. Built from official release.	Most users. Matches Linux Docker behavior.
Podman on FreeBSD currently requires root. All commands must be run as root (or via `doas`/`sudo`).

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

Podman Compose AppJail Director Podman CLI Ansible

services:
  uptime-kuma:
    image: ghcr.io/daemonless/uptime-kuma:latest
    container_name: uptime-kuma
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - UPTIME_KUMA_IS_CONTAINER=1
      - UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC=1
      - PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
      - DATA_DIR=/config
    volumes:
      - "/path/to/containers/uptime-kuma:/config"
    ports:
      - 3001:3001
    annotations:
      org.freebsd.jail.allow.raw_sockets: "true"
    restart: unless-stopped

DIRECTOR_PROJECT=uptime-kuma
PUID=1000
PGID=1000
TZ=UTC
UPTIME_KUMA_IS_CONTAINER=1
UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC=1
PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
DATA_DIR=/config

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  uptime-kuma:
    name: uptime_kuma
    options:
      - container: 'boot args:--pull'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - UPTIME_KUMA_IS_CONTAINER: !ENV '${UPTIME_KUMA_IS_CONTAINER}'
        - UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC: !ENV '${UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC}'
        - PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: !ENV '${PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD}'
        - DATA_DIR: !ENV '${DATA_DIR}'
    volumes:
      - UPTIME_KUMA_CONFIG_PATH: /config
volumes:
  UPTIME_KUMA_CONFIG_PATH:
    device: '/path/to/containers/uptime-kuma'

ARG tag=latest

OPTION overwrite=force
OPTION from=ghcr.io/daemonless/uptime-kuma:${tag}
SET allow.raw_sockets=1

podman run -d --name uptime-kuma \
  -p 3001:3001 \
  --annotation 'org.freebsd.jail.allow.raw_sockets=true' \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e UPTIME_KUMA_IS_CONTAINER=1 \
  -e UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC=1 \
  -e PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 \
  -e DATA_DIR=/config \
  -v /path/to/containers/uptime-kuma:/config \
  ghcr.io/daemonless/uptime-kuma:latest

- name: Deploy uptime-kuma
  containers.podman.podman_container:
    name: uptime-kuma
    image: ghcr.io/daemonless/uptime-kuma:latest
    state: started
    restart_policy: always
    env:
      PUID: "1000"
      PGID: "1000"
      TZ: "UTC"
      UPTIME_KUMA_IS_CONTAINER: "1"
      UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC: "1"
      PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: "1"
      DATA_DIR: "/config"
    ports:
      - "3001:3001"
    volumes:
      - "/path/to/containers/uptime-kuma:/config"
    annotation:
      org.freebsd.jail.allow.raw_sockets: "true"

Interactive Configuration

Parameters

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
`UPTIME_KUMA_IS_CONTAINER`	`1`
`UPTIME_KUMA_ALLOW_ALL_CHROME_EXEC`	`1`
`PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD`	`1`
`DATA_DIR`	`/config`

Volumes

Path	Description
`/config`	Data directory (database, settings)

Ports

Port	Protocol	Description
`3001`	TCP	Web UI

Implementation Details

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

Need help? Join our Discord community.