GLWS · Developer tools

Forgejo.
On your own server.

Run a community-focused Git forge for repositories, issues and collaborative development.

What it is for.

Common uses of Forgejo.

Common uses

  • Self-hosted Git projects
  • Collaborative code review
  • Project issue management

Keep in mind

Check the documentation for the release you install. Repository hosting and optional action runners need separate resource and permission planning.

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 Forgejo documentation ↗ (opens in a new tab)

Things to decide before you install Forgejo.

Advice specific to this application.

Choose your collaboration boundary

Decide whether registration is open, restricted or administrator-managed, and how contributors will authenticate. Plan storage for repositories, attachments and packages alongside the database. Published project visibility and administrator permissions should be deliberate choices.

Keep automation permissions bounded

Optional runners execute project-defined commands, so treat them as a distinct service with its own credentials and limits. Record the installed Forgejo version and retain configuration, repositories and database backups together. Check upgrade notes before changing release series.

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 forgejo

[ ] Supported deployment method

[ ] Authentication and access restrictions

[ ] Independent data backup

[ ] Updates and restoration tested

root@glws:~#

Forgejo 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.