diff --git a/projects/gitea/README.md b/projects/gitea/README.md
new file mode 100644
index 0000000..3e10d60
--- /dev/null
+++ b/projects/gitea/README.md
@@ -0,0 +1,29 @@
+# [gitea](https://about.gitea.com/)
+
+## gitea
+
+### General
+
+- Compose Path: `./projects/gitea/docker-compose.yml`
+
+### Environment
+
+- USER_UID: #for example `1000`
+- USER_GID: #for example `1000`
+- DISABLE_REGISTRATION: #should be set to `true` after initial registration
+
+### Domains
+
+- Service Name: `gitea`
+- Container Port: `3000`
+- HTTPS: `true`
+- Certificate Provider: `Let's Encrypt`
+
+### Volume Backups
+
+- Task Name: `gitea-sqlite`
+- Schedule `0 0 * * *`
+- Service Name: `gitea`
+- Volume: `gitea-giteasqlite-xxx`
+- Keep Latest Backups: `5`
+- Enabled: true
\ No newline at end of file
diff --git a/projects/gitea/docker-compose.yml b/projects/gitea/docker-compose.yml
new file mode 100644
index 0000000..83a7bcd
--- /dev/null
+++ b/projects/gitea/docker-compose.yml
@@ -0,0 +1,23 @@
+version: "3.8"
+
+services:
+  gitea:
+    image: docker.gitea.com/gitea:1.24.4
+    restart: unless-stopped
+    environment:
+      USER_UID: ${USER_UID}
+      USER_GID: ${USER_GID}
+      DISABLE_REGISTRATION: ${DISABLE_REGISTRATION}
+    volumes:
+      - gitea-data:/data
+    expose:
+      - "3000" # Web UI
+      - "22" # SSH (internal only)
+    healthcheck:
+      test: ["CMD", "wget", "-q", "--spider", "http://localhost:3000/"]
+      interval: 15s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  gitea-data: {}