How to set up Gitea
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>:3300
Create 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.