diff --git a/.claude/skills/gitea-mirror-maintenance/SKILL.md b/.claude/skills/gitea-mirror-maintenance/SKILL.md index f4821d0..d7452a8 100644 --- a/.claude/skills/gitea-mirror-maintenance/SKILL.md +++ b/.claude/skills/gitea-mirror-maintenance/SKILL.md @@ -1,12 +1,12 @@ --- name: gitea-mirror-maintenance -description: Detect and clean up failed, broken, or empty Gitea mirror repositories in the Coolify-deployed gitea + gitea-mirror stack, using tea and the gitea-mirror API. Use when the user asks to check mirror health, find failed or empty repos, investigate why a mirror did not sync or clone, delete broken mirror repos, delete archived copies of the user's own deleted repos, clean up duplicates left by renamed, transferred or re-cased GitHub repos, reclaim disk space from partial clones, re-mirror repos that failed, or run routine mirror upkeep. Not for Gitea setup, upgrades, or deployment problems — those belong to `gitea-mirror/compose.yml`. +description: Detect and clean up failed, broken, or empty Gitea mirror repositories in the Coolify-deployed gitea + gitea-mirror stack, using tea and the gitea-mirror API. Use when the user asks to check mirror health, find failed or empty repos, investigate why a mirror did not sync or clone, delete broken mirror repos, delete archived copies of the user's own deleted repos, clean up duplicates left by renamed, transferred or re-cased GitHub repos, reclaim disk space from partial clones, re-mirror repos that failed, or run routine mirror upkeep. Not for Gitea setup, upgrades, or deployment problems — those belong to `gitea/compose.yml`. --- # Gitea Mirror Maintenance Maintain the `gitea` + `gitea-mirror` stack deployed by -`gitea-mirror/compose.yml` on Coolify: find mirror repositories whose pull failed, classify +`gitea/compose.yml` on Coolify: find mirror repositories whose pull failed, classify each failure, then clean up only what is safe to delete. **Scope.** Mirror health auditing and cleanup only. Not Gitea first-run setup, @@ -24,7 +24,7 @@ the host. | Delete a repo | `tea repos delete --login --owner O --name N --force` | | gitea-mirror API | `$GITEA_MIRROR_URL/api/...` with header `x-api-key: $GITEA_MIRROR_API_KEY` | | gitea-mirror key | created in the gitea-mirror UI: Settings → Authentication → API Keys | -| Gitea container log | Coolify MCP `miti-jp`: `get_logs` on the `gitea-mirror` application | +| Gitea container log | Coolify MCP `miti-jp`: `get_logs` on the `gitea` application | Export `GITEA_MIRROR_URL` and `GITEA_MIRROR_API_KEY` in the shell before running the scripts; both live in the composes repo-root `.env`, so diff --git a/README.md b/README.md index a8b677f..9251410 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,7 @@ Each links to its own README for variables, ports, and storage. | [code-server](code-server/README.md) | VS Code in the browser, as a remote dev box | | [couchbase](couchbase/README.md) | Couchbase Server | | [diun](diun/README.md) | Image-update notifier, reading the Docker API through a read-only proxy | -| [gitea-mirror](gitea-mirror/README.md) | Gitea + PostgreSQL + gitea-mirror, mirroring GitHub repos | +| [gitea](gitea/README.md) | Gitea + PostgreSQL + gitea-mirror, mirroring GitHub repos | | [goclaw](goclaw/README.md) | Multi-tenant AI agent gateway, with pgvector PostgreSQL | | [hermes](hermes/README.md) | Hermes Agent with its built-in web dashboard | | [litellm](litellm/README.md) | LiteLLM proxy in front of many LLM providers, with PostgreSQL and Redis | diff --git a/docs/gitea-mirror/troubleshooting.md b/docs/gitea/troubleshooting.md similarity index 90% rename from docs/gitea-mirror/troubleshooting.md rename to docs/gitea/troubleshooting.md index d9fa45b..f9d05a7 100644 --- a/docs/gitea-mirror/troubleshooting.md +++ b/docs/gitea/troubleshooting.md @@ -1,6 +1,6 @@ # gitea-mirror troubleshooting -Applies to `gitea-mirror/compose.yml`. +Applies to `gitea/compose.yml`. ## Gitea cannot connect after changing `POSTGRES_PASSWORD` @@ -14,5 +14,5 @@ docker compose exec db psql -U gitea -c "ALTER USER gitea PASSWORD '';" ## A redeploy kills clones in progress -Gitea restarts and the clone dies with it. Avoid pushing to `gitea-mirror/` +Gitea restarts and the clone dies with it. Avoid pushing to `gitea/` while a large first mirror runs. diff --git a/gitea-mirror/.env.example b/gitea/.env.example similarity index 100% rename from gitea-mirror/.env.example rename to gitea/.env.example diff --git a/gitea-mirror/.gitignore b/gitea/.gitignore similarity index 100% rename from gitea-mirror/.gitignore rename to gitea/.gitignore diff --git a/gitea-mirror/README.md b/gitea/README.md similarity index 99% rename from gitea-mirror/README.md rename to gitea/README.md index d2e68c9..5d5ab84 100644 --- a/gitea-mirror/README.md +++ b/gitea/README.md @@ -1,4 +1,4 @@ -# gitea-mirror +# gitea Self-hosted [Gitea](https://about.gitea.com/) backed by PostgreSQL, with [gitea-mirror](https://github.com/RayLabsHQ/gitea-mirror) mirroring GitHub diff --git a/gitea-mirror/compose.yml b/gitea/compose.yml similarity index 100% rename from gitea-mirror/compose.yml rename to gitea/compose.yml