gitea/README.md

# Gitea

[![Build Status](https://drone.coopcloud.tech/api/badges/coop-cloud/gitea/status.svg)](https://drone.coopcloud.tech/coop-cloud/gitea)

<!-- metadata -->
* **Category**: Development
* **Status**: 3, stable
* **Image**: [`gitea/gitea`](https://hub.docker.com/gitea/gitea), 4, upstream
* **Healthcheck**: Yes
* **Backups**: Yes
* **Email**: ?
* **Tests**: 2
* **SSO**: 3 (OAuth)
<!-- 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`

## Create first user

Run

```bash
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](https://docs.gitea.io/en-us/command-line/) for more options.  Make sure not to forget the `-c /etc/gitea/app.ini`.
Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:34 +00:00			`# Gitea`
Bootstrap Gitea repository 2020-06-17 06:21:19 +00:00
docs: new URLs and auto-format 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)`
Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:34 +00:00
			`<!-- metadata -->`
chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:03 +00:00			`* Category: Development`
Goodbye, emojis! 😢 [ci skip] 2021-11-23 10:19:04 +00:00			`* Status: 3, stable`
			* Image: [`gitea/gitea`](https://hub.docker.com/gitea/gitea), 4, upstream
chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:03 +00:00			`* Healthcheck: Yes`
Update metadata [ci skip] 2021-08-18 01:03:27 +00:00			`* Backups: Yes`
chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:03 +00:00			`* Email: ?`
Goodbye, emojis! 😢 [ci skip] 2021-11-23 10:19:04 +00:00			`* Tests: 2`
			`* SSO: 3 (OAuth)`
Follow new exciting README standard See coop-cloud/organising#31 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`
docs(README): instruction to create first user 2021-12-29 17:13:43 +00:00
			`## Create first user`

			`Run`

			```bash
docs(README): correct command creating new user 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`
docs(README): instruction to create first user 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`.