diff --git a/templates/docker-compose-gitea.yml.tpl b/templates/docker-compose-gitea.yml.tpl
index c460411..0adce76 100644
--- a/templates/docker-compose-gitea.yml.tpl
+++ b/templates/docker-compose-gitea.yml.tpl
@@ -1,3 +1,7 @@
+# Gitea Docker Compose — rendered by phase1_gitea_unraid.sh and phase2_gitea_fedora.sh
+# Variables: GITEA_VERSION, DATA_PATH, GITEA_PORT, GITEA_SSH_PORT
+# DATA_PATH is host-specific (UNRAID_GITEA_DATA_PATH or FEDORA_GITEA_DATA_PATH)
+
 version: "3"
 
 services:
@@ -9,10 +13,16 @@ services:
       - USER_UID=1000
       - USER_GID=1000
     volumes:
-      - ${DATA_PATH}/data:/data
-      - ${DATA_PATH}/config:/data/gitea/conf
+      - ${DATA_PATH}/data:/data                    # Gitea repositories, LFS, avatars, etc.
+      - ${DATA_PATH}/config:/data/gitea/conf       # app.ini lives here
       - /etc/timezone:/etc/timezone:ro
       - /etc/localtime:/etc/localtime:ro
     ports:
-      - "${GITEA_PORT}:3000"
-      - "${GITEA_SSH_PORT}:22"
+      - "${GITEA_PORT}:3000"        # Web UI + API
+      - "${GITEA_SSH_PORT}:22"      # Git over SSH (host port 22 is taken by SSH server)
+    healthcheck:
+      test: ["CMD", "curl", "-sf", "http://localhost:3000/api/v1/version"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 30s