From 1c1d9c676773bf740be86cd84fd0ba907549bf28 Mon Sep 17 00:00:00 2001
From: Thomas Faour <tom@tfao.ca>
Date: Sat, 18 Jul 2026 14:38:55 -0400
Subject: [PATCH] Add Gitea Actions workflow to build/push the server image

Builds server/Dockerfile and pushes to this repo's Gitea Container
Registry (git.thumeit.com/tfaour/espresso-frame-server) on every push to
main that touches server/, tagged both latest and the commit SHA.

docker-compose.yml now sets both image: and build: -- deploy hosts can
docker compose pull to grab the CI-built image without needing this
repo's build context, while local dev can still docker compose build
against Dockerfile changes directly.
---
 .gitea/workflows/server-docker-build.yml | 37 ++++++++++++++++++++++++
 server/README.md                         | 17 +++++++++++
 server/docker-compose.yml                |  1 +
 3 files changed, 55 insertions(+)
 create mode 100644 .gitea/workflows/server-docker-build.yml

diff --git a/.gitea/workflows/server-docker-build.yml b/.gitea/workflows/server-docker-build.yml
new file mode 100644
index 0000000..d2001ff
--- /dev/null
+++ b/.gitea/workflows/server-docker-build.yml
@@ -0,0 +1,37 @@
+name: Build and push server image
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "server/**"
+      - ".gitea/workflows/server-docker-build.yml"
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Gitea Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: git.thumeit.com
+          username: ${{ gitea.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: ./server
+          push: true
+          tags: |
+            git.thumeit.com/tfaour/espresso-frame-server:latest
+            git.thumeit.com/tfaour/espresso-frame-server:${{ gitea.sha }}
diff --git a/server/README.md b/server/README.md
index 8a9ae40..26ded98 100644
--- a/server/README.md
+++ b/server/README.md
@@ -41,6 +41,23 @@ algorithm itself -- it just streams the response straight to the panel.
   color primaries for this panel) -- tune them once you can compare a
   rendered test image against the real panel.
 
+## Deploying a pre-built image
+
+Every push to `main` that touches `server/` triggers a Gitea Actions
+workflow (`.gitea/workflows/server-docker-build.yml`) that builds this
+image and pushes it to this repo's Gitea Container Registry at
+`git.thumeit.com/tfaour/espresso-frame-server`. `docker-compose.yml`
+already points at that image, so a deploy host doesn't need this repo's
+build context at all -- just the compose file:
+
+```
+docker compose pull
+docker compose up -d
+```
+
+`docker compose build` (or `up --build`) still works too, for local
+iteration against your own Dockerfile changes.
+
 ## Local development (without Docker)
 
 ```
diff --git a/server/docker-compose.yml b/server/docker-compose.yml
index b828eb3..ff939a9 100644
--- a/server/docker-compose.yml
+++ b/server/docker-compose.yml
@@ -1,5 +1,6 @@
 services:
   espresso-frame-server:
+    image: git.thumeit.com/tfaour/espresso-frame-server:latest
     build: .
     ports:
       - "8420:8420"