Installation:

• Download Forgejo binary for your CPU architecture and verify the GPG signature.
• Copy the binary to /usr/local/bin/ and make it executable.

# cp forgejo-1.21.5-0-linux-amd64 /usr/local/bin/forgejo
# chmod 755 /usr/local/bin/forgejo

• Ensure git and git-lfs are installed:

# apt install git git-lfs

• Create a user git on the system:

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

• Create necessary directories for Forgejo:

# mkdir /var/lib/forgejo
# chown git:git /var/lib/forgejo && chmod 750 /var/lib/forgejo

# mkdir /etc/forgejo
# chown root:git /etc/forgejo && chmod 770 /etc/forgejo

Optional: Set up database: (If not using SQLite)

• Follow Forgejo's Database Preparation guide for setup.

Install systemd service for Forgejo:

• Download the systemd service script:

# wget -O /etc/systemd/system/forgejo.service https://codeberg.org/forgejo/forgejo/raw/branch/forgejo/contrib/systemd/forgejo.service

• Enable and start the Forgejo service:

# systemctl enable forgejo.service
# systemctl start forgejo.service

Forgejo's web-based configuration:

• Access Forgejo in your browser at http://git.example.com:3000/.
• If encountering issues, check service status and logs:

# systemctl status forgejo.service
# journalctl -n 100 --unit forgejo.service

• Follow on-screen instructions to complete initial configuration.

Further configuration in Forgejo's app.ini:

• Stop Forgejo service:

# systemctl stop forgejo.service

• Make /etc/forgejo/ and app.ini read-only for the git user:

# chmod 750 /etc/forgejo && chmod 640 /etc/forgejo/app.ini

• Edit /etc/forgejo/app.ini to adjust configurations.

• Start Forgejo service again:

# systemctl start forgejo.service

General hints for using Forgejo:

• Run Forgejo CLI as the git user.
• Specify Forgejo work path and config path.
• Optionally, create a script for easier CLI usage:

#!/bin/sh
sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini "$@"

• Make it executable:

# chmod 755 /usr/local/bin/forgejo.sh

Now, Forgejo commands can be executed simply by calling forgejo.sh [command].

To turn the script into a service for systemctl, follow these steps:

1. Open the forgejo.service file for editing:

sudo nano /etc/systemd/system/forgejo.service

2. Update the file to include the User directive:

[Unit]
Description=Forgejo Command Line Interface
After=network.target

[Service]
Type=simple
User=git
ExecStart=/usr/local/bin/forgejo.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

3. Save and close the file.

4. Reload systemd to read the new service file:

sudo systemctl daemon-reload

5. Enable and start the forgejo service:

sudo systemctl enable forgejo.service
sudo systemctl start forgejo.service

Now, the forgejo.sh script will be executed with the git user permissions when managed by systemctl.