Gitea Mirror

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

git backup mirror gitea github self-hosted developer-tools

Ports

Notes

Use Cases

Official Website View on GitHub

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, deployment notes, and where to find the original compose template.

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

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

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

Tandoor Recipes

Self-hosted recipe manager with meal planning and shopping lists.

Maybe

Open-source personal finance OS for managing accounts, investments, and transactions.

Droppy

Self-hosted file manager with upload, download, sharing, and collaboration features.

Page generated 2026-06-23T15:50:08.758Z