A painless self-hosted Git service
Go to file
3wc a0e8ba4839
continuous-integration/drone/push Build is passing Details
chore: publish 2.5.2+1.21.5-rootless release
2024-02-08 14:36:08 -03:00
release Added commit message warning about Pgsql upgrade 2023-05-09 20:31:17 +01:00
.drone.yml Switch to thecoopcloud/stack-ssh-deploy 2023-01-20 23:31:14 -08:00
.env.sample add [repository.upload] support to the configuration 2023-12-07 18:01:05 -08:00
.gitignore Bootstrap Gitea repository 2020-06-17 08:21:19 +02:00
LICENSE Add LICENSE 2020-06-17 08:30:59 +02:00
README.md Update abra syntax in examples (finally) [mass update] 2023-01-19 16:27:03 -08:00
abra.sh add [repository.upload] support to the configuration 2023-12-07 18:01:05 -08:00
app.ini.tmpl add [repository.upload] support to the configuration 2023-12-07 18:01:05 -08:00
compose.forgejo.yml chore: publish 2.2.0+1.19.3-rootless release 2023-06-06 17:31:14 +02:00
compose.mariadb.yml Mariadb to stable lts 10.11.2 2023-05-08 21:03:09 +01:00
compose.postgres.yml chore: publish 2.5.0+1.21.1-rootless release 2023-11-27 13:10:23 +01:00
compose.smtp.yml chore: formatting 2021-10-05 09:42:10 +02:00
compose.yml chore: publish 2.5.2+1.21.5-rootless release 2024-02-08 14:36:08 -03:00
docker-setup.sh.tmpl Don't run installs here 2021-04-29 16:12:14 +02:00

README.md

Gitea

Build Status

  • Category: Development
  • Status: 3, stable
  • Image: gitea/gitea, 4, upstream
  • Healthcheck: Yes
  • Backups: Yes
  • Email: ?
  • Tests: 2
  • SSO: 3 (OAuth)

Basic usage

  1. Set up Docker Swarm and [abra][abra]
  2. Deploy [coop-cloud/traefik][cc-traefik]
  3. abra app new gitea --secrets (optionally with --pass if you'd like to save secrets in pass)
  4. abra app config YOURAPPDOMAIN - be sure to change $DOMAIN to something that resolves to your Docker swarm box
  5. abra app deploy YOURAPPDOMAIN

Create first user

Run

abra app run YOURAPPNAME app gitea -c /etc/gitea/app.ini admin user create --username USERNAME --admin --random-password --email EMAIL

See the Gitea command-line documentation for more options. Make sure not to forget the -c /etc/gitea/app.ini.

Enable SSH

You most certainly want to be able to access your repository over SSH. To do so, make sure you uncomment the right lines in the configuration for traefik.

abra app config YOURTRAEFIKAPP

There uncomment or add these lines:

GITEA_SSH_ENABLED=1
COMPOSE_FILE="compose.yml:compose.gitea.yml"

Then redeploy traefik:

abra app undeploy YOURTRAEFIKAPP
abra app deploy YOURTRAEFIKAPP

You might need to wait a bit. To check if it worked, you can run

telnet my.gitea.example.com 2222

Once you have added a public SSH key, you can check that you can connect to your gitea server with

ssh -T -p 2222 git@my.gitea.example.com

Note that gitea should be configured to listen to port 2222, i.e. GITEA_SSH_PORT=2222 in the gitea config.