← Back to catalog

Self-Host with Docker · Yantr

Gitea Mirror

Mirror GitHub repositories to a self-hosted Gitea or Forgejo instance.

git backup mirror gitea github self-hosted developer-tools

Ports

Deps

Use Cases

Official Website View on GitHub View compose.yml

About

What Gitea Mirror does

Gitea Mirror synchronizes GitHub repositories (public and private) to a Gitea or Forgejo instance. It supports scheduled mirroring, metadata sync (issues, PRs, wikis, releases), Git LFS, organization mirroring, and a dashboard for monitoring sync status.

Install Flow

How to self-host Gitea Mirror

Gitea Mirror can be deployed with standard Docker Compose using the Yantr app catalog. This page collects the basic information searchers usually need first: what Gitea Mirror does, which Docker image Yantr uses, default ports, dependencies, and where to find the original compose template.

If you searched for Gitea Mirror Docker, Gitea Mirror Docker Compose, or self-host Gitea Mirror, this page is the direct landing page for that app in Yantr's catalog.

After deployment, Yantr also lets you publish additional ports later from the stack page using Docker-style syntax. Use mappings like 8080:8080 for a fixed host port or just 8080 to let Docker assign a random host port for container port 8080.

Use Cases

What people run it for

Keep a complete backup of all your GitHub repositories on your own Gitea server, updated automatically on a schedule.

Mirror entire GitHub organizations to Gitea with flexible destination strategies (preserve structure, single org, or flat user).

Sync issues, pull requests, labels, milestones, and wikis alongside code for a full metadata backup.

Use as a disaster-recovery solution so your code remains accessible even if GitHub is unavailable.

Technical Details

Ports, image, and service metadata

Ports

These are the standard container ports Yantr knows about for Gitea Mirror. You can keep the default mapping, remap them, or publish extra ports later after deployment with Docker syntax such as 3000:3000 or 3000.

Port	Protocol	Label
4321	HTTP	Web UI

Docker Image

ghcr.io/raylabshq/gitea-mirror:latest

Service Name

gitea-mirror

Notes

Things to know before you deploy

! First user to sign up becomes the admin — secure the instance immediately after first launch

! Set BETTER_AUTH_SECRET to a long random string in production for secure session signing

! Configure GitHub token and Gitea connection through the web UI after starting

! Supports automatic repo discovery and cleanup of repos deleted from GitHub (v3.4.0+)

! Git LFS mirroring requires LFS to be enabled on your Gitea server

Related Apps

More tools you might pair with Gitea Mirror

noStrudel

Feature-rich Nostr web client for exploring the protocol, viewing events, and managing keys.

socialnostrdecentralized

Fireshare

Self-hosted video sharing designed for game clips.

mediagamingstreaming

WordPress

World's most popular CMS and blogging platform with thousands of themes and plugins.

cmsblogself-hosted

More App Pages

Keep browsing the Yantr catalog

Explore the full app catalog for more self-hosted services, alternatives, and dependencies that work alongside Gitea Mirror.

Browse the catalog View compose.yml

Page generated 2026-05-03T17:57:37.943Z