Managed Forgejo hosting

Pilae installs, patches, backs up and monitors Forgejo for you, on your own servers or in any of 10+ Pilae Cloud regions, six of them in Switzerland and the EU.

From CHF 449EUR 479USD 559 a month on Starter, hosting and onboarding included.

Talk to us about ForgejoSee what it runs on

Runs on
Your own hardware, or a Pilae Cloud region
Replaces
GitHub, GitLab.com, Bitbucket
Licence
GPL-3.0-or-later
Your serversAdvisoryPatchSandboxApprovalDeployYouLive

Forgejo among the engineering and security apps

Source code, container images, secrets and security events. The systems an auditor asks about first, kept where you can show them.

Forgejo system requirements

Before anything is deployed, this is what has to exist. We size it with you in the first session, and we say so when your own hardware is already enough.

Where it runs
Your hardwarebare metal, VMware, Proxmox, Hyper-V or Kubernetes, in your datacentrePilae Cloud regionzur1 fra1 fal1 gra1 ams1 hel1 …machines dedicated to you, in the region your contract namesHTTPS 443 · SSH2222private meshaccess by identityencrypted tunnelencrypted, offsiteForgejopinned, patched, watched02DatabasePostgreSQL03StorageLocal disk + S3 bucket04CI runnersForgejo Runner, separatemachineYour teamthe people you allowYour identity providerKeycloak or Entra IDPilae Agentplans, asks, applies, recordsPilae consoleyou approve each changeYour backup targetstorage you own, at asecond sitea second datacentre,same jurisdictionYour hardwareyour servers, your networkPilae Cloud regionzur1 fra1 fal1 gra1 …private meshby identitytunnelencryptedForgejopinned, patched, watched02DatabasePostgreSQL03StorageLocal disk + S3bucket04CI runnersForgejo Runner,separate machineYour teamthe people you allowYour sign-inKeycloak, Entra IDPilae Agentplans, asks, applies, recordsPilae consoleyour approvalsYour backupsa second sitea second datacentre
On your hardware: Pilae installs Forgejo and what it needs on the machines you choose, the Pilae Agent runs beside it, and encrypted backups go to storage you own at a second location you pick.In a Pilae Cloud region: the same setup on machines dedicated to you, in the region your contract names, with encrypted backups in a second datacentre inside the same jurisdiction.
All 5 requirements, and why each is there
  1. CPU and memory2 vCPU · 4 GBOur starting size for the Forgejo server. Upstream sets no minimum. Large repositories and many mirrors are what grow it, and runners are sized separately.
  2. DatabasePostgreSQLUpstream also supports MySQL, MariaDB and SQLite, which it suggests for low to moderate activity. Moving to another database later is, in its own words, not a trivial task, so we start on PostgreSQL.
  3. StorageLocal disk + S3 bucketGit repositories live on a filesystem. LFS objects, packages, attachments and Actions logs and artifacts go to an S3-compatible bucket. Code search across repositories needs about six times the repository size on disk, so it is sized before it is switched on.
  4. CI runnersForgejo Runner, separate machineA runner executes whatever a workflow tells it to, and upstream says plainly that this is remote code execution. Runners sit on machines of their own, with no privileged containers and no route to anything they do not need.
  5. NetworkHTTPS 443 · SSH 2222The web interface and Git over HTTPS go through the Pilae gate if you publish them. Git over SSH answers on the private network only, on a port apart from the machine’s own SSH.

Running Forgejo in production: what it takes

  1. Deploy the server on PostgreSQL

    A pinned Forgejo build we have run, on PostgreSQL, with repositories on local disk and LFS, packages and attachments in an S3-compatible bucket from the first day.

  2. Sign in through OIDC, offboard in Forgejo too

    OpenID Connect through Keycloak or Microsoft Entra ID, accounts created on first sign-in, and directory groups mapped to organisation teams at each sign-in. The directory does not reach SSH keys and access tokens, so offboarding also disables the Forgejo account.

  3. Run CI on isolated runners

    Forgejo Runner on machines of its own, jobs in unprivileged containers, ephemeral runners where the risk warrants it, and actions fetched from mirrors on your instance rather than from the internet.

  4. Capture all three at one moment

    Database, repositories and bucket are captured together, daily, encrypted, to an offsite location in the country your contract names. On Enterprise, once a month we restore the set into a scratch instance and clone a repository from it.

  5. Upgrade, then run forgejo doctor

    Forgejo refuses to start an older release on a database a newer one has migrated, so the rollback is the backup taken just before. The Pilae Agent tests each upgrade on a copy, waits for your approval, applies it in your window, checks it with forgejo doctor and records it in the console.

From our runbook

Forgejo configuration: storage, sign-in and CI

; /etc/forgejo/app.ini (excerpt), acme, zur1
[server]
DOMAIN           = git.acme.internal
ROOT_URL         = https://git.acme.internal/
SSH_DOMAIN       = git.acme.internal
SSH_PORT         = 2222
LFS_START_SERVER = true

[database]
DB_TYPE  = postgres
HOST     = db-01.internal:5432
NAME     = forgejo
USER     = forgejo
SSL_MODE = require

[repository]
ROOT = /srv/forgejo/repositories

[storage]
STORAGE_TYPE   = minio
MINIO_ENDPOINT = s3.zur1.internal
MINIO_BUCKET   = acme-forgejo
MINIO_USE_SSL  = true

[security]
INSTALL_LOCK   = true
SECRET_KEY_URI = file:/run/secrets/forgejo_secret_key

[service]
REQUIRE_SIGNIN_VIEW              = true
ENABLE_INTERNAL_SIGNIN           = false
ALLOW_ONLY_EXTERNAL_REGISTRATION = true

[oauth2_client]
ENABLE_AUTO_REGISTRATION = true
USERNAME                 = preferred_username

[actions]
ENABLED             = true
; uses: actions/checkout resolves to a mirror on this instance
DEFAULT_ACTIONS_URL = https://git.acme.internal

[migrations]
; during the move from GitHub only; release assets and LFS come from githubusercontent.com
ALLOWED_DOMAINS = github.com, *.github.com, *.githubusercontent.com
An example app.ini excerpt, kept in your repository with the compose files. Repositories stay on disk and the rest goes to a bucket. Sign-in comes only from your identity provider. Actions resolve to mirrors on the instance, so fetching one does not depend on a host outside your network. The secret key sits in its own file and is backed up with the data: without it, a restore cannot decrypt what Forgejo encrypted.

Migrating from GitHub to Forgejo

Forgejo's migration tool reads a GitHub repository through the API and brings across the code, issues, pull requests with their reviews, labels, milestones, releases, the wiki and LFS objects. Comments keep their author's GitHub name, and are tied to a Forgejo account only where that person has linked a GitHub login. Actions secrets stay behind, because GitHub never lets them be read back, and so do Discussions, Projects, branch protection rules, webhooks and access permissions. The same tool reads GitLab.com and Bitbucket Data Center; a repository on bitbucket.org comes across through plain Git, code only. CI is the long part. As long as a repository has no .forgejo/workflows or .gitea/workflows directory, which Forgejo would read instead, it runs the workflows in .github/workflows as it finds them, and many fail on the first run. Forgejo Actions is designed to be familiar rather than compatible, and most runners default to a small Debian image with Node.js where GitHub offers a much larger Ubuntu one.

  • Migration guideHow to migrate from GitHub to ForgejoMove GitHub repositories to self-hosted Forgejo: import code, issues and pull requests, rebuild what stays behind, move CI to Forgejo Actions, switch remotes.
  • ServiceSaaS migrationA fixed-scope migration off Google Workspace, Microsoft 365, Zapier, Airtable and ChatGPT to open-source apps, with a parallel run and a cutover plan.

Moving from GitHub to Forgejo, step by step

  1. List what does not travel: Per repository: Actions secrets, webhooks, deploy keys, branch protection and app integrations. None of it comes across in the import, so each item gets an owner and a line in the runbook before anything moves.
  2. Prove the workflows on a trial import: Runners with the labels your workflows ask for go up first. A few representative repositories are imported and their workflows run on Forgejo, and we fix what breaks while GitHub is still where people work.
  3. Import in batches: Each repository comes across in one import, history, issues and pull requests together. The GitHub API rate limit sets the pace for a large organisation, so we move repositories in batches and freeze each batch on GitHub as it goes.
  4. Switch remotes, archive GitHub: Developers add their SSH keys to Forgejo and point their remotes at it. The GitHub repositories are archived read-only, and old links keep resolving until you decide to delete them.

What Forgejo is, and who runs it

Git hosting, code review, issues, packages and CI in one service, run in Switzerland, the EU or your own datacentre, with CI runners on machines of their own.

Self-hosted Forgejo for Git, code review and CI

Forgejo is a software forge: Git hosting with pull requests and code review, issues and project boards, a wiki, releases, a package registry and CI through Forgejo Actions. The registry takes more than twenty formats, container images, npm, Maven and PyPI among them; where images also need vulnerability scanning, a Docker Hub proxy cache or replication between sites, Harbor sits beside it. Forgejo is a single Go program, light enough that the machine is rarely the constraint, and it covers what most teams use GitHub or GitLab for day to day.

The project began in 2022 as a fork of Gitea, after Gitea’s domains and trademark were transferred to a for-profit company. It has been a hard fork since early 2024. It is governed by its contributors, under the umbrella of Codeberg e.V., a non-profit association registered in Berlin that holds its domains. A Gitea instance on one of the older releases upgrades to Forgejo in place; one on a newer release moves across through the migration tool.

Read the full briefFold the brief

Forgejo runs on a dedicated machine on your own hardware or in a Pilae Cloud region, Zurich or one of five in the EU among the 10+ we run, and answers only on your private network. Source code, its history and the secrets CI uses to deploy it are often the most sensitive things an engineering team holds, and they stay in the jurisdiction you picked.

Forgejo in production: CI runners, backups and upgrades

CI is the part that needs care. Whoever can change a workflow can run code on the runner, so runners go on machines of their own, jobs run in unprivileged containers, and actions resolve from mirrors on your instance. Sign-in goes through Keycloak or Entra ID over OpenID Connect, with directory groups mapped to teams, and self-registration stays off. Probes check the instance every 60 seconds and alert an engineer.

Forgejo’s documentation is candid about backups. A consistent one needs the database, the repositories and the bucket captured at the same point in time, and the database copy inside its all-in-one dump has long-standing bugs. So the nightly backup stops Forgejo while it runs, at an hour you choose, takes all three with their own tools, and sends them encrypted to an offsite location in the country your contract names. On Enterprise, we restore the set into a scratch instance every month and record the test in the console. Upgrades go through the Pilae Agent, tested on a copy, approved by you and applied in your window, with the pre-upgrade backup as the rollback.

Forgejo licence: GPL, with no paid edition

Forgejo and Forgejo Runner are both GPL-3.0-or-later. Releases before October 2024 were MIT, and files inherited from Gitea keep their MIT headers inside the GPL whole. Every feature ships in the one release: there is no paid edition and no enterprise folder, and the project has registered no trademarks. The GPL’s obligations attach when you distribute the software, and running it for your own organisation triggers none of them. If you need the wider scope GitLab bundles, we operate GitLab as well. Our operation follows the published plans. Talk to us about the repositories you want to move off GitHub.

What Pilae is responsible for

The same commitments on every app we run, Forgejo included, and what stays yours. How the platform does it.

Ours

  • A pinned version: A version we have run, not whatever latest resolves to that day.
  • A runbook: What it depends on, how it fails, what to do about it. In your repository.
  • Daily backups: Encrypted and offsite, and on Enterprise restored every month. A backup nobody has restored is a file.
  • A patch window: Security updates in a window you agreed, with a rollback ready.
  • Someone watching: Every endpoint probed on the minute. An alert reaches a person, not a dashboard nobody opens.

Yours

  • The credentials: You hold them. Ours are separate, named, logged and revocable with one command.
  • The approval: We ask before anything changes outside an agreed window.
  • The exit: The machine, the data, the compose files and the runbook are already yours. Nothing stops when our access does.

Who runs it

Forgejo runs on Starter from CHF 449EUR 479USD 559 a month in Pilae Cloud, or on Business with up to three apps on your own servers.

Compare the plans

Forgejo: common questions

Is Forgejo open source?

Yes. Forgejo is free software under GPL-3.0-or-later, and so is Forgejo Runner. Releases before October 2024 were MIT, and many files inherited from Gitea still carry MIT headers inside the GPL whole. There is no paid edition and no enterprise build: every feature is in the one release.

Will our GitHub Actions workflows run on Forgejo?

Many will, after changes. Forgejo Actions reads the same YAML workflow format, but upstream says it is designed to be familiar to GitHub users, not compatible. Runner images are smaller, some keys in the github context are missing, and job keys such as permissions and continue-on-error are ignored. We run each workflow on a trial import and fix what breaks before the switch.

Where do our repositories live?

On one dedicated machine, yours or ours in Zurich, Falkenstein or another Pilae region, in ISO 27001-certified datacentres. Repositories sit on that machine's disk, LFS objects and packages in a bucket in the same region, and runners can sit on your premises even when the server does not.

Can we sign in with Microsoft Entra ID or Keycloak?

Yes, through OpenID Connect, with directory groups mapped to Forgejo teams. LDAP works as well. Forgejo has no SAML support, so a directory that only speaks SAML goes through Keycloak as a broker.

How does Forgejo compare with GitLab?

Forgejo is smaller and lighter. It covers Git hosting, review, issues, packages and CI in one service and leaves the rest to the tools you choose. GitLab puts more into one product, including planning and security features in its paid tiers, and needs a larger machine to run. Teams that depend on what only GitLab bundles are usually better staying on it, and we run GitLab as well.

Ask the engineers who would run your Forgejo

Thirty minutes on the deployment you already have, or the one you are about to start.

Talk to us about Forgejo

Plan your Forgejo deployment

Costs and savings

Product comparisons

SaaS alternatives

Migration plans

Architectures