Forgejo

Self-hosted git forge with issues, pull requests and CI hooks.

DevOpsTested on FreeBSD16.0.6_1MIT

jailops app install forgejo

Add --dry-run to see every step first. From the console: open Apps, pick Forgejo and press Install; the dialog takes the jail name, the network and the storage, and Preview steps shows the plan before anything runs. See the console.

About

Forgejo is a compact, self-hosted software forge: git hosting, issues, pull requests, wikis, packages and a web interface. The package runs it as the git user under /var/db/forgejo with the configuration in /usr/local/etc/forgejo/conf/app.ini.

The installation leaves the configuration to the web installer: the first visit to port 3000 asks for the database (SQLite under /var/db/forgejo works out of the box) and the first account, which becomes the administrator.

What you get

Ports

  • 3000/tcp http exposeThe web interface and the HTTP git endpoint.

Data on its own datasets

  • /var/db/forgejo volume var-db-forgejoRepositories, the SQLite database, attachments, indexes and sessions.

Configuration

  • /usr/local/etc/forgejo/conf/app.iniThe configuration the web installer writes; secrets included, keep it private. Restart: service forgejo restart.

Logs

  • /var/log/forgejoLog files, when the [log] section writes files.
  • /var/log/daemon.logWhat the service prints; daemon(8) sends it to syslog as daemon.info.

Health check

TCP: port 3000 accepts a connection, retried for up to 60 seconds.

Services

  • forgejo: enabled and started; forgejo_configcheck_enable="NO"

Setup, once, before the first start

Three commands, run in the jail as argv, without a shell:

  1. /bin/rm -f /usr/local/etc/forgejo/conf/app.ini
  2. /usr/sbin/chown -R git:git /usr/local/etc/forgejo
  3. /usr/sbin/chown -R git:git /var/db/forgejo /var/log/forgejo

After the installation

The notes of the definition, shown after the installation too.

Open http://ADDRESS:3000/ to finish the setup in the browser: choose SQLite3 with /var/db/forgejo/forgejo.db, keep the repository root /var/db/forgejo/forgejo-repositories, set the server domain and base URL to the address you reach the jail by, and register the first user, who becomes the administrator. The installer writes app.ini; later changes to it need service forgejo restart inside the jail.

How it connects

jailops app allow forgejo from @web

This opens port 3000/tcp of this app to the jail web, and nothing else. The service itself must listen on the jail's address and accept the client.

An installed app is closed: nothing reaches it, not even its own network, until you allow a source. A source is a jail (@web), a jail of another project (@project/web), an address set, an address or prefix, or host. jailops app access forgejo lists who may connect. The names here are jail names: jailops app install names the jail after the app unless --name says otherwise.