Reference repo for running Gitea with docker
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Noah Williams de052a0b6b Grammatical change for clarity 10 months ago
nginx Generify URL in nginx conf file 11 months ago
.gitignore Add mysql folder to gitignore 11 months ago
LICENSE Initial commit 1 year ago Grammatical change for clarity 10 months ago
docker-compose.yml Change mysql container to MariaDB 11 months ago Change dir of LE certs 11 months ago

Reference repo for running Gitea with docker


This instance of Gitea uses the following components:

It assumes a Debian based host in the UID/GID assigned to various containers, such as maintream Debian or Ubuntu.


Adding the Git user

You should create the Linux git user and use sudo instead of running all commands as root

adduser git

You can leave all the misc info blank at the prompts - but don't forget to set a password!

You'll also need to add the git user to the sudoers group, so you can use it to run the privileged Docker commands:

sudo usermod -a -G sudo git

Nginx Setup

  1. In nginx/sites-enabled/code.conf, change all lines containing to

  2. In the docker-compose.yml file, change ROOT_URL to Do the same for SSH_DOMAIN, omitting the https.

Gitea Setup

Gitea requires a database (in this case MariaDB) to work. To set this up, you'll need a .env config file to give pass the DB login info to Docker.

  1. Create the file
touch ./.env
  1. Open the file in a text editor and create a variable:

Note: You could do this directly in your docker-compose.yml file, but this is not a good idea in production, as it usually involves committing your credentials in git.

Host setup

Since the Gitea container contains a built-in SSH server running on port 22 to enable git over ssh, you will get an error if you try to run this configuration out of the box.

The simplest way to enable git over SSH is to change the port used for SSH on the host machine.

You can change this by editing the file /etc/ssh/sshd_config, uncommenting Port and setting the value to something like 2222.

Note: If you have a firewall like UFW configured, don't forget to allow incoming traffic on the new port before changing this setting, or you will be locked out of your server!

To gain remote access to the machine again, simply prepend -p 2222 to your future SSH commands:

ssh -p 2222

SSL Setup

Note: This section is incomplete.

  1. In the script, change the line containing to, and change to your email.
  2. Make executable
sudo chmod +x ./
  1. Run the script:
sudo ./

Server Standup

Once you've finished setting these variables, you should be good to go.

To start the instance, simply start the containers with Docker-compose:

docker-compose up -d