---
slug: forgejo-setup-notes
title: "Forgejo Setup Notes"
date: "2026-03-09T03:15:27-04:00"
draft: true
---

A month ago I installed [Forgejo][].  I've been using it to develop a
couple of projects.

TODO:
- server setup
  - apache configuration
  - systemd service
  - container
- runner setup
  - rootless podman w/ dedicated `runner` user
  - rootless podman runners on odroid n2l w/armbian, pi5, and
    debian
  - note about podman socket and enable-linger
  - systemd service (plus config override)
  - custom config to enable host networking
  - armbian: install nft (check `pi.txt`)
  - labels.  note about ubuntu-act

pros:
- Great UI.  Very similar to [GitLab][]
- almost everything I care about: issues, PRs, kanban,
  projects, organization, MFA,

- easier to install and upgrade than [gitlab][]
- faster and less resource-intensive than [gitlab][]
- forgejo actions syntax is very similar to github actions
- used by codeberg.org
- plays nice with podman and rootless podman

cons:
- no gists
- finicky runner setup
- instructions are good, but there are gaps
- minor differences in action syntax but they pop up
- some actions only support older versions relative to
  github

other:

- see gist for notes about forgejo, and podman command
- runner running in rootless podman as runner user
  - note about podman socket and enable-linger
  - systemd service (plus config override)
  - custom config to enable host networking
  - armbian: install nft
  - ubuntu-latest label (use ubuntu-act)
- TODO: see notes/{pi,k3,x1}.txt
- TODO: actions/cache <https://code.forgejo.org/actions/cache>
- runner multi-connect:
  <https://forgejo.org/2026-02-monthly-report/#forgejo-runner-v1270>