diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index dcb1a04..ed28087 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -1,5 +1,11 @@
 name: CI
 
+# Required repo secret: PACKAGES_TOKEN
+# Generate at: Gitea → User Settings → Applications → Generate New Token
+# Scopes: read:package, write:package
+# Save as: Repository → Settings → Actions → Secrets → PACKAGES_TOKEN
+# Note: GITHUB_TOKEN is read-only for packages in Gitea (issue #23642).
+
 on:
   push:
     branches: ["**"]
@@ -113,8 +119,8 @@ jobs:
         uses: docker/login-action@v3
         with:
           registry: gitea.mrixs.me
-          username: ${{ gitea.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
+          username: ${{ gitea.repository_owner }}
+          password: ${{ secrets.PACKAGES_TOKEN }}
 
       - name: Build and push
         uses: docker/build-push-action@v5