Skip to content

Gitea Gitea

Description / nameInput element
Container Registry
Container Configuration Root Path
Timezone
User ID
Group ID
Gitea Host Port
Gitea /config Path

Build Status Last Commit OCI Pulls

Lightweight self-hosted Git service — a community managed fork of Gogs written in Go.
Port 3000
Registry ghcr.io/daemonless/gitea
Daemonless daemonless/gitea
Source go-gitea/gitea
Website about.gitea.com

Version Tags

Tag Description Best For
latest Upstream Binary. Built from official release. Most users — recommended.
pkg FreeBSD Quarterly. Uses stable, tested packages. Production stability.
pkg-latest FreeBSD Latest. Rolling package updates. Staying current.

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.

Deployment

Database Where the app keeps its data. The default needs nothing else running.

gitea:latest — data in /containers/gitea

A file in the app's config folder. Right for one person, nothing extra to run.

Save as compose.yaml:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
name: gitea

services:
  gitea:
    image: ghcr.io/daemonless/gitea:latest
    container_name: gitea
    restart: unless-stopped

    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - SSH_PORT=2222
      - SSH_LISTEN_PORT=22
      - GITEA__database__DB_TYPE=${GITEA__database__DB_TYPE:-}
      - GITEA__database__HOST=${GITEA__database__HOST:-}
      - GITEA__database__USER=${GITEA__database__USER:-}
      - GITEA__database__PASSWD=${GITEA__database__PASSWD:-}
      - GITEA__database__NAME=${GITEA__database__NAME:-}

    volumes:
      - "/containers/gitea:/config"

    ports:
      - "3000:3000"
      - "2222:22"

Then run podman-compose up -d.

Database Where the app keeps its data. The default needs nothing else running.

gitea:latest — data in /containers/gitea

A file in the app's config folder. Right for one person, nothing extra to run.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# .env

DIRECTOR_PROJECT=gitea
PUID=1000
PGID=1000
TZ=UTC
SSH_PORT=2222
SSH_LISTEN_PORT=22
GITEA__database__DB_TYPE=sqlite3
GITEA__database__HOST=
GITEA__database__USER=
GITEA__database__PASSWD=<GITEA__DATABASE__PASSWD>
GITEA__database__NAME=

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  gitea:
    name: gitea
    options:
      - container: 'args:--pull'
      - expose: '3000:3000 proto:tcp'
      - expose: '2222:22 proto:tcp'
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - SSH_PORT: !ENV '${SSH_PORT}'
        - SSH_LISTEN_PORT: !ENV '${SSH_LISTEN_PORT}'
        - GITEA__database__DB_TYPE: !ENV '${GITEA__database__DB_TYPE}'
        - GITEA__database__HOST: !ENV '${GITEA__database__HOST}'
        - GITEA__database__USER: !ENV '${GITEA__database__USER}'
        - GITEA__database__PASSWD: !ENV '${GITEA__database__PASSWD}'
        - GITEA__database__NAME: !ENV '${GITEA__database__NAME}'
    volumes:
      - GITEA_CONFIG_PATH: /config
volumes:
  GITEA_CONFIG_PATH:
    device: '/containers/gitea'

1
2
3
4
5
6
7
# Makejail

ARG tag=latest

OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/gitea:${tag}

Save the files above, then run appjail-director up.

Open http://<server>:3000 from another machine (the server's own browser can't use a published port).

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 2222 Published port for sshd (used in clone URLs)
SSH_LISTEN_PORT 22 Port on which sshd listens inside the container
GITEA__database__DB_TYPE `` sqlite3, postgres or mysql; set by the Database choice. Any non-empty GITEA__
__ goes into app.ini on start
GITEA__database__HOST `` Database host, optionally host:port (Database choice)
GITEA__database__USER `` Database user (Database choice)
GITEA__database__PASSWD <GITEA__DATABASE__PASSWD> Database password (Database choice)
GITEA__database__NAME `` Database name (Database choice)

Volumes

Path Description
/config Configuration, repositories, and data directory

Ports

Port Protocol Description
3000 TCP Web UI
22 TCP SSH port

First run

If no configuration file exists when the container starts, it will generate an initial default config file at /config/custom/conf/app.ini. You can make configuration changes in this file later (e.g. SMTP configuration) and they will be preserved across container restarts.

SSH Setup

If you modify the port mapping from the default 2222:22 you need to update the 2 environment variables described below accordingly.

SSH_LISTEN_PORT env var

This variable indicates on which port Gitea's ssh server listens inside the container. If your port mapping for ssh is 2222:22, this variable should be set to 22. This variable is used on every container start to modify the Gitea configuration.

SSH_PORT env var

This variable tells Gitea on which port the ssh server is reachable from the outside and is used when constructing the ssh URLs shown in Gitea's web UI. If your port mapping for ssh is 2222:22, this variable should be set to 2222. This variable is used only during the first container startup to create the initial configuration file for Gitea. If you want to modify the SSH_PORT later, you need to change the configuration in the [server] section of /config/custom/conf/app.ini.

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.1).

Need help? Join our Discord community.