aboutsummaryrefslogtreecommitdiff
path: root/doc/book
diff options
context:
space:
mode:
authorQuentin Dufour <quentin@deuxfleurs.fr>2021-11-10 12:41:09 +0100
committerQuentin Dufour <quentin@deuxfleurs.fr>2021-11-10 12:41:09 +0100
commit1928f59d5415481c51214e5ce29c2208678650d5 (patch)
treec5f51661e3d2c2db1711e842a49365b1b0f71b58 /doc/book
parent323514be15f3e0790e2bfdf4b78aff0e13f10ceb (diff)
downloadgarage-1928f59d5415481c51214e5ce29c2208678650d5.tar.gz
garage-1928f59d5415481c51214e5ce29c2208678650d5.zip
Add documentation for Gitea.
Diffstat (limited to 'doc/book')
-rw-r--r--doc/book/src/connect/repositories.md52
1 files changed, 49 insertions, 3 deletions
diff --git a/doc/book/src/connect/repositories.md b/doc/book/src/connect/repositories.md
index 9c88ca3e..6e106cb5 100644
--- a/doc/book/src/connect/repositories.md
+++ b/doc/book/src/connect/repositories.md
@@ -1,11 +1,57 @@
# Repositories (Docker, Nix, Git...)
-## Sourcehut
-## Gitlab
+## Gitea
+
+You can use Garage with Gitea to store your [git LFS](https://git-lfs.github.com/) data, your users' avatar, and their attachements.
+You can configure a different target for each data type (check `[lfs]` and `[attachment]` sections of the Gitea documentation) and you can provide a default one through the `[storage]` section.
+
+Let's start by creating a key and a bucket (your key id and secret will be needed later, keep them somewhere):
+
+```bash
+garage key new --name gitea-key
+garage bucket create gitea
+garage bucket allow gitea --read --write --key gitea-key
+```
+
+Then you can edit your configuration (by default `/etc/gitea/conf/app.ini`):
+
+```ini
+[storage]
+STORAGE_TYPE=minio
+MINIO_ENDPOINT=localhost:3900
+MINIO_ACCESS_KEY_ID=GKxxx
+MINIO_SECRET_ACCESS_KEY=xxxx
+MINIO_BUCKET=gitea
+MINIO_LOCATION=garage
+MINIO_USE_SSL=false
+```
-## Gitea & Gogs
+You can also pass this configuration through environment variables:
+```bash
+GITEA__storage__STORAGE_TYPE=minio
+GITEA__storage__MINIO_ENDPOINT=localhost:3900
+GITEA__storage__MINIO_ACCESS_KEY_ID=GKxxx
+GITEA__storage__MINIO_SECRET_ACCESS_KEY=xxxx
+GITEA__storage__MINIO_BUCKET=gitea
+GITEA__storage__MINIO_LOCATION=garage
+GITEA__storage__MINIO_USE_SSL=false
+```
+
+Then restart your gitea instance and try to upload a custom avatar.
+If it worked, you should see some content in your gitea bucket (you must configure your `aws` command before):
+
+```
+$ aws s3 ls s3://gitea/avatars/
+2021-11-10 12:35:47 190034 616ba79ae2b84f565c33d72c2ec50861
+
+```
+
+
+*External link:* [Gitea Documentation > Configuration Cheat Sheet](https://docs.gitea.io/en-us/config-cheat-sheet/)
+
+## Gitlab
## Docker