How to set up Gitea
· Updated 31 July 2026 · SparkBox team
Your own private Git server. This guide covers how to access it, log in for the first time, configure the basics, and where its data lives so you can back it up.
1. What is Gitea?
A lightweight, self-hosted Git service. Host your code repositories, manage issues, and collaborate on projects without relying on GitHub or GitLab. Fast, simple, and easy to set up.
2. How to access it
Once it's enabled, Gitea runs on your SparkBox at:
http://<your-NAS-IP>:3300Create an account and start pushing repositories right away
3. First login
No default account. On first visit, Gitea shows an install page — the first user you register becomes the admin automatically.
If it instead asks for a password you didn't set, check Settings → Passwords in your SparkBox dashboard — every auto-generated credential is listed there.
4. Tips
- Create your first repository and push code from your local machine
- Set up SSH keys for passwordless git push and pull
5. Settings you can change
You can set these when you enable the module, or later from Apps → Gitea in the dashboard:
- Database Password — Configurable value.
6. Where your data lives
Gitea's config and persistent data are stored on the SparkBox host under:
/opt/sparkbox/modules/gitea/config/Backups via the SparkBox dashboard's Backup tile include this directory by default, so a single restore brings Gitea back to its current state on a fresh install.
Next steps
That's Gitea live on SparkBox.
If something doesn't match what you see, post in d/sparkbox or hit us up on YouTube. Every SparkBox bug gets patched; every UX-stumble in this guide gets rewritten.
Questions, or did this not match your box?
Every guide here came from a real problem someone hit. If yours behaves differently, say so — that is how these get corrected, and how the fix gets prioritised.
We answer there rather than in a comment box, because that is where the people who have already solved it are.