Forgejo
Self-hosted git forge with issues, pull requests and CI hooks.
jailops app install forgejoAdd --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/tcphttp exposeThe web interface and the HTTP git endpoint.
Data on its own datasets
/var/db/forgejovolumevar-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:
/bin/rm -f /usr/local/etc/forgejo/conf/app.ini/usr/sbin/chown -R git:git /usr/local/etc/forgejo/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.