Skip to content
A Docker Compose file for Gitea
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.env.dist initial commit Sep 12, 2017
.gitignore added systemd service template Mar 10, 2018 moved configuration part to upper section Mar 10, 2018
docker-gitea.service.dist added systemd service template Mar 10, 2018


A Docker Compose file for Gitea - Git with a cup of tea (

Data will be saved in separate docker volumes to enable easy upgrades!


  • docker
  • docker-compose

Getting Started

  1. Copy .env.dist to .env and make your modifications
  2. Start docker containers:
$ docker-compose up -d

After that open gitea installer via browser: http://localhost:3000 and fill the form according your .env settings.

Set gitea-db:3306 in Host field and complete setup.

After setup is completed register a new user (use link from the navigation bar).

The first registered user has admin privileges.

Environment Configuration

GITEA_VERSION Docker-Image-Version latest
GITEA_HOSTNAME Hostname for Gitea Application localhost
GITEA_WEB_PORT GUI-Port for accessing Gitea 3000
GITEA_SSH_PORT Port for accessing Gitea via SSH 2222
MYSQL_ROOT_PASSWORD MySQL root password root
MYSQL_DATABASE Database name for gitea gitea
MYSQL_USER Database user for gitea gitea
MYSQL_PASSWORD Password for MySQL user gitea

Create systemd unit

  1. Copy docker-gitea.service.dist to docker-gitea.service
  2. Adjust WorkingDirectory in service file if needed
  3. Create symbolic link: ln -s docker-gitea.service /etc/systemd/system/docker-gitea.service
  4. Start service: systemctl start docker-gitea
  5. (optional) Enable autostart at boot: systemctl enable docker-gitea
You can’t perform that action at this time.