1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
Gitea Mirror
Development128MB+ RAM
Automatically mirror GitHub repositories to a self-hosted Gitea instance — keep an offline backup of every repo you care about
developmentdevtoolsgiteamirroropen-sourceself-hosteddocker
Deploy Gitea Mirror in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select Gitea Mirror
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy Gitea Mirror on a VPS with Server Compass
Use the Gitea Mirror template in Server Compass to deploy the web app, then verify the setup screen and health endpoint.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for Gitea Mirror
Use the template picker search to find Gitea Mirror in the Server Compass template catalog.
4
Step 4Select the Gitea Mirror template
Choose the Gitea Mirror template. Server Compass fills the web app container, persistent data volume, public auth URL, and setup secrets.
5
Step 5Review the Gitea Mirror settings
Confirm the app name, public auth URL, auth secret, Gitea URL, tokens, and web port. In this run, the app was named gitea-mirror-demo and used host web port 4246.
6
Step 6Deploy Gitea Mirror
Review the generated compose settings, confirm the Gitea Mirror web port is available, and click Deploy.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the Gitea Mirror image, starts the container, and verifies the stack.
8
Step 8Confirm Gitea Mirror is running
After deployment finishes, return to the Apps tab and confirm the Gitea Mirror app is marked Running with its application URL available.
9
Step 9Open Gitea Mirror in the browser
Open the application URL in a browser. The Gitea Mirror setup screen confirms the self-hosted web app is reachable and ready for the first admin account.
After Gitea Mirror Opens
- Create the first Gitea Mirror admin account from the setup screen.
- Replace the tutorial placeholder Gitea URL and tokens with a real Gitea or Forgejo URL plus a scoped create/write token.
- Add a GitHub token if you need private repositories, organization access, or higher API limits.
- Use the built-in connection test before scheduling mirror jobs.
- Configure HTTPS before production use.
- Trigger a small first mirror job and confirm the repository appears in Gitea before enabling broad scheduled sync.
Verified Result
The Gitea Mirror setup admin page loaded successfully, and `/api/health` returned HTTP 200 with database status connected.
Gitea Mirror deployment questions
What does the Gitea Mirror template deploy?
It deploys the Gitea Mirror web app with a persistent SQLite data volume, public auth URL, generated auth secret, and healthcheck.
Which port did the tutorial use?
The tutorial used host web port 4246, which maps to the Gitea Mirror HTTP listener on container port 4321.
Does Gitea Mirror need setup after deployment?
Yes. Create the first admin account, configure your real Gitea or Forgejo URL and token, add a GitHub token if needed, then test the connection before mirroring repositories.
Should this become a blog post?
No. The deployment guide should live on the Gitea Mirror template detail page and be linked from the reusable template deployment docs page.
After Deployment
After deploying Gitea Mirror with Server Compass, complete these steps to finish setup
1
Make sure your Gitea instance is reachable at GITEA_URL
2
Generate a Gitea API token (Settings → Applications → Generate New Token)
3
(Optional) Generate a GitHub PAT with `repo` scope for private repos
4
Visit http://YOUR_SERVER_IP:{{PORT}}, log in, and select repos to mirror
5
Trigger the first sync manually and verify the repo appears in Gitea
Need help? Check out our documentation for detailed guides.
Gitea Mirror FAQ
Common questions about self-hosting Gitea Mirror
How do I deploy Gitea Mirror with Server Compass?
Simply download Server Compass, connect to your VPS, and select Gitea Mirror from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Gitea Mirror?
Gitea Mirror requires a minimum of 128MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Gitea Mirror data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Gitea Mirror backup and restore procedures.
How do I update Gitea Mirror to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Gitea Mirror image will be pulled and deployed with zero downtime.
Is Gitea Mirror free to self-host?
Gitea Mirror is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Related Templates
View all Development
PocketBase
Open-source backend in a single file with realtime database, auth, and file storage
Appwrite
Open-source backend-as-a-service - self-hosted Firebase alternative
Parse Server
Open-source backend framework with dashboard
Supabase
Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio
Ready to Self-Host Gitea Mirror?
Download Server Compass and deploy Gitea Mirror to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass