type: service
status: active
timestamp: 2026-06-24
tags: [service, git-host, mirror, backup, codeberg, forgejo, free-tier, foss]

Codeberg.org — push-mirror target for chirag127 + chirag127

FOSS non-profit git mirror #2 — push-mirror via GH Actions, 750 MiB soft cap

Codeberg.org — push-mirror target

Role

Codeberg.org is mirror host #2 in the 6-host DR strategy. It is also the daily DR mirror for chirag127 via the separate codeberg-mirror.yml workflow. Non-profit, FOSS-focused, Forgejo-based. No payment, no credit card, completely free.

Free Tier

Limit	Value
Repos	100 per user/org (increases available on request)
Git storage	750 MiB per user/org total
LFS + packages + releases	Additional 1.5 GiB
Private repos	100 MiB limit for “non-promoted” (proprietary) content
Organizations	Supported (own storage quota applies)
Pull mirroring	❌ Disabled on Codeberg’s public instance

Our text-heavy repos are < 100 MB total; well within limits.

Authentication

Field	Value
Token type	Access Token (Forgejo API token)
Token URL	`https://codeberg.org/user/settings/applications`
Required scope	`write:repository`
Env var names	`MIRROR_CODEBERG_TOKEN`, `MIRROR_CODEBERG_USERNAME`
Git URL format	`https://USERNAME:[email protected]/username/repo.git`
Auth header (API)	`Authorization: token TOKEN`

How to get the token

Log in at https://codeberg.org
Go to Settings → Applications (/user/settings/applications)
Under Manage Access Tokens, click Generate Token
Token name: oriz-mirror-bot
Scope: tick write:repository
Click Generate Token — copy immediately, shown once
Store as chirag127 org-level GitHub secret(s) — paste value into .env then gh secret set <NAME> --org chirag127 --visibility all < <(printf %s "$VALUE"). Full loop: runbooks/platform/mirror-all-hosts-setup.md Step 2.

API — Create Repo (idempotent)

# For user namespace
curl -s -X POST "https://codeberg.org/api/v1/user/repos" \
  -H "Authorization: token ${MIRROR_CODEBERG_TOKEN}" \
  -H "Content-Type: application/json" \
  -d "{\"name\":\"${REPO_NAME}\",\"private\":false,\"auto_init\":false,\"description\":\"Mirror of github.com/chirag127/${REPO_NAME}\"}" \
  || true  # 409 = exists — fine

# For org namespace
curl -s -X POST "https://codeberg.org/api/v1/org/chirag127/repos" \
  -H "Authorization: token ${MIRROR_CODEBERG_TOKEN}" \
  -H "Content-Type: application/json" \
  -d "{\"name\":\"${REPO_NAME}\",\"private\":false,\"auto_init\":false}"

API docs (Swagger): https://codeberg.org/api/swagger

Rate Limits

No documented public rate limits; respect normal usage — sleep 0.5 between creation API calls in loops.

Pull Mirror — DISABLED on Codeberg

Forgejo (the underlying software) supports pull mirroring natively, but Codeberg’s administrators have explicitly disabled it to reduce server load. There is no workaround — you cannot have Codeberg auto-pull from GitHub.

Solution: GitHub Actions push to Codeberg on schedule (already implemented in codeberg-mirror.yml and mirror-all.yml).

Mirror URL patterns

# Personal repos
https://${MIRROR_CODEBERG_USERNAME}:${MIRROR_CODEBERG_TOKEN}@codeberg.org/${MIRROR_CODEBERG_USERNAME}/${REPO_NAME}.git

# Org repos (chirag127)
https://chirag127:${MIRROR_CODEBERG_TOKEN}@codeberg.org/chirag127/${REPO_NAME}.git

Failure modes

Symptom	Cause	Fix
`403 Forbidden` on push	Token missing `write:repository` scope	Regenerate token
`404 Not Found` on push	Mirror repo not pre-created	Run repo-creation script
`413 Payload Too Large`	Repo exceeds size limits	Use BFG to clean large blobs
Storage quota exceeded	750 MiB total hit	Delete old repos or request increase

Cross-refs

Full setup → ../../../runbooks/mirror-all-hosts-setup.md
Daily chirag127 Codeberg mirror → ../../../runbooks/platform/codeberg-mirror-2026-06-23.md
9-host decision → ../../decisions/ops/mirror-to-9-popular-alternatives-2026-06-28.md

Edit on GitHub · Back to index