From b79725d99fd5551e7eb300735115deb0fb39e9a5 Mon Sep 17 00:00:00 2001
From: ntimo <ntimo@users.noreply.github.com>
Date: Sun, 10 Jun 2018 09:29:31 +0200
Subject: [PATCH] added Gitea docs

---
 docs/third_party-gitea.md | 52 +++++++++++++++++++++++++++++++++++++++
 mkdocs.yml                |  1 +
 2 files changed, 53 insertions(+)
 create mode 100644 docs/third_party-gitea.md

diff --git a/docs/third_party-gitea.md b/docs/third_party-gitea.md
new file mode 100644
index 000000000..6ae8bd0d0
--- /dev/null
+++ b/docs/third_party-gitea.md
@@ -0,0 +1,52 @@
+With Gitea' ability to authenticate over SMTP it is trivial to integrate it with mailcow. Few changes are needed:
+
+1\. Open `docker-compose.override.yml` and add gitea:
+
+```
+version: '2.1'
+services:
+
+		gitea-mailcow:
+			image: gitea/gitea:latest
+			volumes:
+				- ./data/gitea:/data
+			networks:
+				mailcow-network:
+					aliases:
+						- gitea
+			ports:
+				- "${GITEA_SSH_PORT:-127.0.0.1:4000}:22"
+```
+
+2\. Create `data/conf/nginx/site.gitea.custom`, add:
+```
+location /gitea/ {
+		proxy_pass http://gitea:3000/;
+}
+```
+
+3\. Open `mailcow.conf` and define the binding you want gitea to use for SSH. Example:
+
+```
+GITEA_SSH_PORT=127.0.0.1:4000
+```
+
+5\. Run `docker-compose up -d` to bring up the gitea container and run `docker-compose restart nginx-mailcow` afterwards.
+
+6\. Open `http://${MAILCOW_HOSTNAME}/gitea/`, for example `http://mx.example.org/gitea/`. For database details set `mysql` as database host. Use the value of DBNAME found in mailcow.conf as database name, DBUSER as database user and DBPASS as database password.
+
+7\. Once the installation is complete, login as admin and set "settings" -> "authorization" -> "enable SMTP". SMTP Host should be `postfix` with port `587`, set `Skip TLS Verify` as we are using an unlisted SAN ("postfix" is most likely not part of your certificate).
+
+8\. Create `data/gitea/gitea/conf/app.ini` and set following values. You can consult [gitea cheat sheet](https://docs.gitea.io/en-us/config-cheat-sheet/) for their meaning and other possible values.
+
+```
+[server]
+SSH_LISTEN_PORT = 22
+# For GITEA_SSH_PORT=127.0.0.1:4000 in mailcow.conf, set:
+SSH_DOMAIN = 127.0.0.1
+SSH_PORT = 4000
+# For MAILCOW_HOSTNAME=mx.example.org in mailcow.conf (and default ports for HTTPS), set:
+ROOT_URL = https://mx.example.org/gitea/
+```
+
+9\. Restart gitea with `docker-compose restart gitea-mailcow`. Your users should be able to login with mailcow managed accounts.
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 7a58601d0..6e3cb6109 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -89,6 +89,7 @@ pages:
   - 'Roundcube': 'third_party-roundcube.md'
   - 'Portainer': 'third_party-portainer.md'
   - 'Gogs': 'third_party-gogs.md'
+  - 'Gitea': 'third_party-gitea.md'
 extra:
   logo: 'images/logo.svg'
   palette: