From a7def019b631fdee30dacb400ec9b90e94cb2471 Mon Sep 17 00:00:00 2001
From: James Skemp <strivinglife@gmail.com>
Date: Sun, 6 Aug 2023 09:37:44 -0500
Subject: [PATCH] Add simple page on running Gitea in Docker locally

---
 src/SUMMARY.md              |  1 +
 src/hosting/gitea-docker.md | 54 +++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 src/hosting/gitea-docker.md

diff --git a/src/SUMMARY.md b/src/SUMMARY.md
index 6b350bd..41e94fc 100644
--- a/src/SUMMARY.md
+++ b/src/SUMMARY.md
@@ -32,6 +32,7 @@
 ## Self-hosting
 * [Gitea](hosting/gitea.md)
 	* [Updating Gitea](hosting/updating-gitea.md)
+	* [Hosting in Docker](hosting/gitea-docker.md)
 
 ## Related
 * [Related links](related.md)
diff --git a/src/hosting/gitea-docker.md b/src/hosting/gitea-docker.md
new file mode 100644
index 0000000..cb12bb0
--- /dev/null
+++ b/src/hosting/gitea-docker.md
@@ -0,0 +1,54 @@
+# Hosting Gitea in Docker
+This is specific to a local/internal instance, running in Docker (24.0.5) on Ubuntu (22.04), with Docker Compose (2.20.2).
+
+Latest Gitea at the time of writing is 1.20.1.
+
+> Warning: This likely isn't the most secure.
+
+1. Create a new user on the server for Git.
+	- `sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git`
+	- Make note of the UID and GID's returned.
+2. `mkdir gitea && cd gitea`
+3. `nano docker-compose.yml`
+	- Populate it with the contents below, setting the correct `USER_UID` and `USER_GID` values.
+4. Start it up.
+	- `docker compose up -d`
+5. Navigate to http://server-ip:port and create an account to verify.
+
+To update Gitea config, you can update the local file. Assuming docker-compose.yml was saved to ~/docker/gitea:
+
+`sudo vim docker/gitea/gitea/gitea/conf/app.ini`
+
+The following may be beneficial to add:
+
+- `repository` > `ENABLE_PUSH_CREATE_USER = true`
+- `repository` > `ENABLE_PUSH_CREATE_ORG = true`
+
+## docker-compose.yml
+> Replace 117 and 122 UID and GID with the appropriate values. Replace `8070` and `2227` with the desired ports.
+
+```yaml
+version: "3"
+
+networks:
+  gitea:
+    external: false
+
+services:
+  server:
+    image: gitea/gitea:1.20.1
+    container_name: gitea
+    environment:
+      - USER_UID=117
+      - USER_GID=122
+    restart: always
+    networks:
+      - gitea
+    volumes:
+      - ./gitea:/data
+      - /etc/timezone:/etc/timezone:ro
+      - /etc/localtime:/etc/localtime:ro
+    ports:
+      - "8070:3000"
+      - "2227:22"
+```