Skip to content
daemonless
gitea
Public

About

Lightweight self-hosted Git service — a community managed fork of Gogs written in Go.

daemonless.io/images/gitea/

Topics

containerdaemonlessdevopsfreebsdfreebsd-jailgitgiteainfrastructureocioci-imagepodmanself-hosted

Resources

Readme
BSD-2-Clause license
Activity
Custom properties

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository
BranchesTags

Repository files navigation

Gitea

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
Source https://github.com/go-gitea/gitea
Website https://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.

Prerequisites

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

Deployment

Podman Compose

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

SQLite (default)

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

1. Save as .env and fill in what is empty:



2. Save as compose.yaml:


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:
      - /path/to/containers/gitea:/config

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


Then run podman-compose up -d.


PostgreSQL


One more container, its data in its own folder. For a household, or an app that wants it.


1. Save as .env and fill in what is empty:


# Database: PostgreSQL
GITEA__database__DB_TYPE=postgres
GITEA__database__HOST=postgres
GITEA__database__USER=gitea
GITEA__database__PASSWD=  # set one
GITEA__database__NAME=gitea
DATABASE_LOCATION=/containers/gitea/postgres


2. Save as compose.yaml:


name: gitea

services:
  gitea:
    depends_on: [postgres]
    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:
      - /path/to/containers/gitea:/config

    ports:
      - "3000:3000"
      - "2222:22"
  postgres:
    image: ghcr.io/daemonless/postgres:17
    restart: always
    annotations:
      org.freebsd.jail.allow.sysvipc: "true"
    environment:
      - POSTGRES_USER=${GITEA__database__USER}
      - POSTGRES_PASSWORD=${GITEA__database__PASSWD}
      - POSTGRES_DB=${GITEA__database__NAME}
    volumes:
      - "${DATABASE_LOCATION}:/var/lib/postgresql/data"


Then run podman-compose up -d.


MariaDB


One more container, its data in its own folder. If you already know MariaDB, or the app prefers it.


1. Save as .env and fill in what is empty:


# Database: MariaDB
GITEA__database__DB_TYPE=mysql
GITEA__database__HOST=mariadb
GITEA__database__USER=gitea
GITEA__database__PASSWD=  # set one
GITEA__database__NAME=gitea
DATABASE_LOCATION=/containers/gitea/mariadb


2. Save as compose.yaml:


name: gitea

services:
  gitea:
    depends_on: [mariadb]
    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:
      - /path/to/containers/gitea:/config

    ports:
      - "3000:3000"
      - "2222:22"
  mariadb:
    image: ghcr.io/daemonless/mariadb:11.4
    restart: always
    environment:
      - MYSQL_USER=${GITEA__database__USER}
      - MYSQL_PASSWORD=${GITEA__database__PASSWD}
      - MYSQL_DATABASE=${GITEA__database__NAME}
      - MYSQL_ROOT_PASSWORD=${GITEA__database__PASSWD}
    volumes:
      - "${DATABASE_LOCATION}:/config"


Then run podman-compose up -d.


Your own


A database you already run, here or on another machine. Nothing extra runs; you give the address and the account.


1. Save as .env and fill in Kind, Host, User, Password, Database:


# Database: Your own
GITEA__database__DB_TYPE=  # Kind: postgres | mysql
GITEA__database__HOST=  # Host
GITEA__database__USER=  # User
GITEA__database__PASSWD=  # Password
GITEA__database__NAME=  # Database


2. Save as compose.yaml:


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:
      - /path/to/containers/gitea:/config

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


Then run podman-compose up -d.


AppJail Director


SQLite (default)


.env:


# .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=



appjail-director.yml:


# 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
volumes:
  gitea:
    device: '/containers/gitea'


Makejail:


# 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.


PostgreSQL


.env:


# .env

DIRECTOR_PROJECT=gitea
PUID=1000
PGID=1000
TZ=UTC
SSH_PORT=2222
SSH_LISTEN_PORT=22
GITEA__database__DB_TYPE=postgres
GITEA__database__HOST=gitea_postgres
GITEA__database__USER=gitea
GITEA__database__PASSWD=
GITEA__database__NAME=gitea
DATABASE_LOCATION=/containers/gitea/postgres



appjail-director.yml:


# 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
  gitea-postgres:
    name: gitea_postgres
    priority: 10
    options:
      - from: ghcr.io/daemonless/postgres:17
      - template: !ENV '${PWD}/postgres-template.conf'
    oci:
      environment:
        - POSTGRES_USER: !ENV '${GITEA__database__USER}'
        - POSTGRES_PASSWORD: !ENV '${GITEA__database__PASSWD}'
        - POSTGRES_DB: !ENV '${GITEA__database__NAME}'
    volumes:
      - database: /var/lib/postgresql/data
volumes:
  gitea:
    device: '/containers/gitea'
  database:
    device: !ENV '${DATABASE_LOCATION}'


Makejail:


# Makejail

ARG tag=latest

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



postgres-template.conf:


# The jail PostgreSQL runs in: SysV shared memory, which a jail does not
# get by default. ip4/ip6 are set here because the director's ip4_inherit
# option is a no-op in AppJail 5.5.0.

exec.start: "/bin/sh /etc/rc"
exec.stop: "/bin/sh /etc/rc.shutdown jail"
sysvmsg: new
sysvsem: new
sysvshm: new
mount.devfs
persist
ip4: inherit
ip6: inherit



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


MariaDB


.env:


# .env

DIRECTOR_PROJECT=gitea
PUID=1000
PGID=1000
TZ=UTC
SSH_PORT=2222
SSH_LISTEN_PORT=22
GITEA__database__DB_TYPE=mysql
GITEA__database__HOST=gitea_mariadb
GITEA__database__USER=gitea
GITEA__database__PASSWD=
GITEA__database__NAME=gitea
DATABASE_LOCATION=/containers/gitea/mariadb



appjail-director.yml:


# 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
  gitea-mariadb:
    name: gitea_mariadb
    priority: 10
    options:
      - from: ghcr.io/daemonless/mariadb:11.4
      - template: !ENV '${PWD}/template.conf'
    oci:
      environment:
        - MYSQL_USER: !ENV '${GITEA__database__USER}'
        - MYSQL_PASSWORD: !ENV '${GITEA__database__PASSWD}'
        - MYSQL_DATABASE: !ENV '${GITEA__database__NAME}'
        - MYSQL_ROOT_PASSWORD: !ENV '${GITEA__database__PASSWD}'
    volumes:
      - database: /config
volumes:
  gitea:
    device: '/containers/gitea'
  database:
    device: !ENV '${DATABASE_LOCATION}'


Makejail:


# 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.


Your own


.env:


# .env

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



appjail-director.yml:


# 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
volumes:
  gitea:
    device: '/containers/gitea'


Makejail:


# 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.


Access at: http://localhost:3000


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.


Architectures: amd64
User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000)
Base: FreeBSD 15.1




Need help? Join our Discord community.


About
Lightweight self-hosted Git service — a community managed fork of Gogs written in Go.
daemonless.io/images/gitea/
Topics
containerdaemonlessdevopsfreebsdfreebsd-jailgitgiteainfrastructureocioci-imagepodmanself-hosted
Resources
Readme
BSD-2-Clause license
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Contributors
Languages