SparkBox / Guides / Gitea setup

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

5. Settings you can change

You can set these when you enable the module, or later from Apps → Gitea in the dashboard:

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.

Get SparkBox → More guides →

About this guide: Generated from the SparkBox module manifest and verified against a live install. If you spot something that doesn't match your experience, tell us in d/sparkbox.