0 Fork 0

mirror of https://github.com/tiennm99/composes.git synced 2026-10-11 03:13:16 +00:00

Files

T

tiennm99 198329c008 docs: move service issue notes from READMEs into docs/<service>

Service READMEs now cover only what the service is and how to deploy it.
Known issues, log noise and troubleshooting move to docs/<service>/, named
after the service directory, so editing them never redeploys the service.
Drop alloy's validate workflow, which never ran from a subdirectory.

2026-10-04 09:46:08 +07:00

.env.example

feat(gitea-mirror): raise the Gitea clone timeout to one hour

2026-10-03 11:23:32 +07:00

.gitignore

chore: drop ollama, netdata, per-service licenses and stale plans

2026-09-19 12:43:05 +07:00

compose.yml

fix(gitea-mirror): keep gitea-mirror waiting as long as Gitea clones

2026-10-03 13:38:02 +07:00

README.md

docs: move service issue notes from READMEs into docs/<service>

2026-10-04 09:46:08 +07:00

README.md

gitea-mirror

Self-hosted Gitea backed by PostgreSQL, with gitea-mirror mirroring GitHub repositories into it.

Services

Service	Image	Internal port	Domain
`db`	`postgres:16-alpine`	5432	none
`gitea`	`gitea/gitea:28`	3000	`GITEA_ROOT_URL`
`gitea-mirror`	`ghcr.io/raylabshq/gitea-mirror:latest`	4321	`GITEA_MIRROR_URL`

In Coolify, give gitea and gitea-mirror each a domain on their internal port, matching the two URL variables.

gitea waits for db to pass its health check. gitea checks /api/healthz; the gitea-mirror image ships its own health check.

Variables

Variable	Feeds	Notes
`POSTGRES_PASSWORD`	`db`, `gitea`	Defaults to `gitea`.
`GITEA_ROOT_URL`	Gitea `server.ROOT_URL`	Public URL, with trailing slash. Gitea builds clone URLs and redirects from it.
`GITEA_CLONE_TIMEOUT`	Gitea `git.timeout` `MIGRATE` and `MIRROR`; gitea-mirror `BUN_CONFIG_HTTP_IDLE_TIMEOUT`	Seconds a mirror's first clone or a later fetch may run. Defaults to `3600`; at most `14340`.
`BETTER_AUTH_SECRET`	gitea-mirror	Signs sessions and encrypts its login keys. Generate with `openssl rand -base64 32`.
`ENCRYPTION_SECRET`	gitea-mirror	Encrypts the stored GitHub and Gitea tokens. Generate with `openssl rand -base64 48`.
`GITEA_MIRROR_URL`	`BETTER_AUTH_URL`, `PUBLIC_BETTER_AUTH_URL`, `BETTER_AUTH_TRUSTED_ORIGINS`	Public URL of the mirror UI, no trailing slash.

Behind a reverse proxy, gitea-mirror rejects sign-in with "invalid origin" unless all three Better Auth variables hold the external URL, so one variable feeds them all.

Both secrets are set explicitly rather than left to the image, which would otherwise generate its own into gitea-mirror-data. Data encrypted under one secret is unreadable under another, so moving the data to a new deployment means carrying the secrets with it. Never change either on an existing install.

Choices

HTTPS only. The proxy routes HTTP, not SSH, so Gitea's SSH server is disabled and the UI offers HTTPS clone URLs only.
One-hour clone timeout. Gitea's defaults (600 s to migrate, 300 s to fetch) cut off multi-gigabyte repositories mid-clone, leaving empty mirrors that still hold gigabytes of unreachable packfiles.
gitea-mirror waits as long as Gitea clones. Gitea's migrate API sends nothing until the clone ends, and Bun's fetch drops a connection idle for 5 minutes. gitea-mirror then marks the repository failed while Gitea keeps cloning; on retry it finds the half-made repository and marks it mirrored. If that clone later fails, Gitea keeps an empty repository with no mirror record, which never syncs. BUN_CONFIG_HTTP_IDLE_TIMEOUT takes the same value as the clone timeout so the request outlives the clone. Bun caps it at 239 minutes, so a larger GITEA_CLONE_TIMEOUT stops helping there.
gitea/gitea:28. Gitea publishes major tags; the major pin takes updates without a surprise major upgrade.
gitea-mirror:latest with pull_policy: always: upstream publishes no major tag, so every redeploy takes the newest release.
postgres:16-alpine stays on 16: a new Postgres major cannot read the existing data directory without a dump and restore.

Usage

Complete Gitea's first-run setup at GITEA_ROOT_URL, create an access token, then configure mirroring at GITEA_MIRROR_URL. In gitea-mirror, set the Gitea URL to http://gitea:3000 so it talks to Gitea over the internal network.

Storage

Volume	Holds
`db-data`	PostgreSQL data
`gitea-data`	Repositories, Gitea config and state
`gitea-mirror-data`	Mirror job database and generated secrets