GLWS · Developer tools

Gitea.
On your own server.

Host Git repositories, issues and code review in a compact development workspace.

What it is for.

Common uses of Gitea.

Common uses

  • Private Git repositories
  • Issue tracking
  • Pull request reviews

Keep in mind

Choose a supported installation and database combination. Build runners are separate workloads and may need significantly more resources than the repository service.

Sizing and setup.

Planning examples, not official minimum requirements.

Developer tools

Start with the whole stack.

Memory planning example
2 GB
Server environment
Linux / CPU-based VPS
Deployment method
Follow the publisher's documentation
Installed for you?
No. Your preference is saved with your configuration

Before you install

Check the current supported operating systems, deployment methods, dependencies and licence terms. What you need depends on your workload, not just the application's name.

Large datasets and busy workloads can need far more memory, storage or different hardware. Any external API or service subscriptions are separate.

Read the Gitea documentation ↗ (opens in a new tab)

Things to decide before you install Gitea.

Advice specific to this application.

Separate repositories from build execution

A repository service stores code and coordinates reviews, while a runner executes project commands. Inventory repository size, large-file storage and active users before sizing the service. Keep build execution isolated and apply resource limits appropriate to the jobs.

Retain more than bare Git data

Repositories, issues, users, attachments and configuration contribute to a complete recovery. Document SSH and HTTPS access paths and the location of the database. Test a backup by restoring the service and checking both repository operations and the web interface.

Get the server ready.

Linux guides that help with this setup.

A repeatable deployment.

Four steps that make the environment easier to maintain.

  1. 01

    Check requirements

    Read the publisher's instructions and choose a supported installation method.

  2. 02

    Limit access

    Protect the dashboard, credentials and network endpoints before you expose any service.

  3. 03

    Persist your data

    Work out where the application keeps its state and store it separately from replaceable runtime files.

  4. 04

    Test recovery

    Back up the data and configuration, then check that you can restore them.

A checklist to keep.

Run through it before and after you install.

glws / application planningbash

$ application-checklist --name gitea

[ ] Supported deployment method

[ ] Authentication and access restrictions

[ ] Independent data backup

[ ] Updates and restoration tested

root@glws:~#

Gitea questions.

Quick answers before you choose resources.

Does choosing this application install it?

No. The configurator only saves your application preference. It does not connect to any infrastructure or run an installer.

How much memory will I need?

Use the planning example as a starting point only. Check the publisher's requirements and measure the whole stack under a realistic workload.

Who maintains the application?

You do. Self-hosted applications need updates, configuration and recovery planning from the operator. The publisher's documentation describes supported maintenance.

Where can I learn the server basics?

The knowledge base covers Linux access, packages, services, firewalls and backups.

Similar applications.

Other tools you might run alongside or instead.