From 1208ccd89d686f98081dfd4f30f6f533fafe5b02 Mon Sep 17 00:00:00 2001
From: Ed_ <edwardgz@gmail.com>
Date: Wed, 3 Jun 2026 08:48:42 -0400
Subject: [PATCH] docs(docker): add Gitea registry push and pull instructions

---
 docs/guide_docker_deployment.md | 39 ++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/docs/guide_docker_deployment.md b/docs/guide_docker_deployment.md
index f2ea8033..006d48f7 100644
--- a/docs/guide_docker_deployment.md
+++ b/docs/guide_docker_deployment.md
@@ -21,7 +21,7 @@ This guide covers deploying Manual Slop on Unraid (or any Docker host) using the
 
 From the repo root:
 ```bash
-docker build -t manual_slop:latest .
+./scripts/docker_build.sh
 ```
 
 Or use the helper:
@@ -29,6 +29,16 @@ Or use the helper:
 ./scripts/docker_build.sh
 ```
 
+## Pushing to Gitea Registry
+
+If your Gitea instance has a container registry, push the built image:
+
+```bash
+./scripts/docker_push.sh
+```
+
+This reads your Gitea credentials from `credentials.toml` (registry_url, username, token) and pushes to `https://git.cozyair.dev/ed/manual_slop:latest`.
+
 ## Running the Container
 
 Edit `docker-compose.yml` to set your volume paths and provider keys (via `.env` file or environment).
@@ -73,11 +83,38 @@ See [guide_tools.md](guide_tools.md) for the full Hook API reference.
 - `/projects` — Mounted from `/mnt/user/projects` by default. Your project workspaces live here. The `manual_slop.toml` per project is in this directory.
 - `/config` — Mounted from `/mnt/user/appdata/manual_slop` by default. App state: presets, personas, log directory, workspace profiles.
 
+## Pulling from Gitea Registry on Unraid
+
+If you pushed the image to Gitea's container registry, pull it on Unraid:
+
+```bash
+# Login to Gitea registry
+docker login git.cozyair.dev -u ed
+
+# Pull the image
+docker pull git.cozyair.dev/ed/manual_slop:latest
+
+# Run the container
+docker run -d \
+  --name manual_slop \
+  -p 8999:8999 \
+  -p 8080:8080 \
+  -v /mnt/user/projects:/projects \
+  -v /mnt/user/appdata/manual_slop:/config \
+  git.cozyair.dev/ed/manual_slop:latest
+```
+
+Or use `docker-compose.yml` after editing the image name:
+```yaml
+image: git.cozyair.dev/ed/manual_slop:latest
+```
+
 ## Updating
 
 ```bash
 git pull
 docker build -t manual_slop:latest .
+./scripts/docker_push.sh  # if using Gitea registry
 docker compose up -d
 ```