Merge pull request #89 from ntimo/master

Added Gitea third party docs

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.

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: