SparkBox / Guides / Gitea

Gitea: open it, first login, settings, fixes

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. This is the short card for it — the two minutes after you press Enable, and the page to come back to when something is off.

SparkBox Apps page — one-click install cards for every module
SparkBox Apps page — one-click install cards for every module

Open it

Dashboard → Apps → Gitea → Open. The direct address on your network is:

http://<your-box-IP>:3300

Create an account and start pushing repositories right away

SparkBox dashboard login screen
SparkBox dashboard login screen
SparkBox Settings page
SparkBox Settings page

First login

No default account. On first visit, Gitea shows an install page — the first user you register becomes the admin automatically.

Any password the installer generated for you is under Settings → Passwords; the Open button offers to copy it.

Worth knowing

  • Create your first repository and push code from your local machine
  • Set up SSH keys for passwordless git push and pull

When it breaks

If it will not open, check the app card first — a red dot means it is restarting or unhealthy, and this walkthrough reads the reason from its log. Tom AI on the dashboard can do the same for you.

Where your data lives

/opt/sparkbox/modules/gitea/config/

Included in the dashboard's Backup by default. Restoring that backup on a fresh install brings Gitea back exactly as it was.

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.

Ask in the community →

We answer there rather than in a comment box, because that is where the people who have already solved it are.

About this page: Rendered from the app's own manifest in SparkBox, so the ports, settings and first-login steps match the version you are running. If something does not match what you see, say so in d/sparkbox — the manifest gets fixed and every copy of this page with it.