Forgejo

Description / name	Input element
Container Registry
Container Configuration Root Path
Timezone
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.
`15-pkg-latest` / `lts-pkg-latest`	FreeBSD Latest. Rolling package updates.	Newest FreeBSD packages.
`14-pkg-latest`	FreeBSD Latest. Rolling package updates.	Newest FreeBSD packages.

Root Privileges Required

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  # 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/to/containers/forgejo:/config"
    ports:
      - "3000:3000"
      - "2222:22"
    restart: unless-stopped

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

- 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"

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.