Forgejo Setup Guide

Forgejo is a self-hosted lightweight Git server, running on the Web Application VM.

Installation (Binary)

1. Download Binary Check Forgejo releases for the latest version.

   wget <FORGEJO_BINARY_URL>
   chmod +x forgejo-linux-amd64
   sudo cp forgejo-linux-amd64 /usr/local/bin/forgejo

2. Create User

   sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git

3. Create Directories

   sudo mkdir /var/lib/forgejo
   sudo chown git:git /var/lib/forgejo && sudo chmod 750 /var/lib/forgejo
   sudo mkdir /etc/forgejo
   sudo chown root:git /etc/forgejo && sudo chmod 770 /etc/forgejo

4. Systemd Service Download the sample service file from the Forgejo repository.

   sudo wget -O /etc/systemd/system/forgejo.service <SERVICE_FILE_URL>
   sudo systemctl enable forgejo.service
   sudo systemctl start forgejo.service

Configuration

• Config File: /etc/forgejo/app.ini
• Port: 3001 (Internal), proxied via git.<INTERNAL_DOMAIN>.

Admin Commands

To change a user's password via CLI:

sudo forgejo admin user change-password --username <username> --password <new_password> --config /etc/forgejo/app.ini