2021-03-02 16:38:34 +00:00
# Gitea
2020-06-17 06:21:19 +00:00
2021-10-05 07:42:53 +00:00
[![Build Status ](https://drone.coopcloud.tech/api/badges/coop-cloud/gitea/status.svg )](https://drone.coopcloud.tech/coop-cloud/gitea)
2021-03-02 16:38:34 +00:00
<!-- metadata -->
2021-11-22 11:42:03 +00:00
* **Category**: Development
2021-11-23 10:19:04 +00:00
* **Status**: 3, stable
* **Image**: [`gitea/gitea` ](https://hub.docker.com/gitea/gitea ), 4, upstream
2021-11-22 11:42:03 +00:00
* **Healthcheck**: Yes
2021-08-18 01:03:27 +00:00
* **Backups**: Yes
2021-11-22 11:42:03 +00:00
* **Email**: ?
2021-11-23 10:19:04 +00:00
* **Tests**: 2
* **SSO**: 3 (OAuth)
2021-03-02 16:38:34 +00:00
<!-- endmetadata -->
## 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 YOURAPPDOMAIN config` - be sure to change `$DOMAIN` to something that resolves to
your Docker swarm box
5. `abra app YOURAPPDOMAIN deploy`
2021-12-29 17:13:43 +00:00
## Create first user
Run
```bash
2021-12-31 12:32:40 +00:00
abra app run YOURAPPNAME app gitea -c /etc/gitea/app.ini admin user create --username USERNAME --admin --random-password --email EMAIL
2021-12-29 17:13:43 +00:00
```
See the [Gitea command-line documentation ](https://docs.gitea.io/en-us/command-line/ ) for more options. Make sure not to forget the `-c /etc/gitea/app.ini` .