Forgejo

Description / name	Input element
Container Registry	GitHub Container Registry
Container Configuration Root Path
Timezone	UTC
User ID
Group ID
Forgejo Host Port
Forgejo /config Path

Forgejo is a self-hosted lightweight software forge

Port	3000
Registry	ghcr.io/daemonless/forgejo
Daemonless	daemonless/forgejo
Source	codeberg.org/forgejo/forgejo
Website	forgejo.org

Version Tags

Tag	Description	Best For
15 / lts	Built from latest upstream source release of the v15 branch.	Alternative build.
15-latest / lts-latest	Built from latest upstream source release of the v15 branch with latest FreeBSD packages.	Most users. Matches Linux Docker behavior.
11	Built from latest upstream source release of the v11 branch.	Alternative build.
latest	Built from latest upstream source release.	Alternative build.
lts-pkg	FreeBSD Quarterly. Uses stable, tested packages.	Production stability.
lts-pkg-latest	FreeBSD Latest. Rolling package updates.	Newest FreeBSD packages.
14-pkg / pkg	FreeBSD Quarterly. Uses stable, tested packages.	Production stability.
14-pkg-latest / pkg-latest	FreeBSD Latest. Rolling package updates.	Newest FreeBSD packages.
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 Podman CLI Ansible

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

Download compose.yaml

podman run -d --name forgejo \
  -p 3000:3000 \
  -p 2222:22 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e SSH_PORT=22 \
  -v /path/to/containers/forgejo:/config \
  ghcr.io/daemonless/forgejo:latest

Download run.sh

- name: Deploy forgejo
  containers.podman.podman_container:
    name: forgejo
    image: ghcr.io/daemonless/forgejo:latest
    state: started
    restart_policy: always
    env:
      PUID: "1000"
      PGID: "1000"
      TZ: "UTC"
      SSH_PORT: "22"
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - "/path/to/containers/forgejo:/config"

Download forgejo-deploy.yaml

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
SSH_PORT	22	Port for sshd

Volumes

Path	Description
/config	Configuration, repositories, and data directory

Ports

Port	Protocol	Description
3000	TCP	Web UI
22	TCP	SSH port

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.