Web service example - Forgejo

Introduction#

Walkthrough to install a code repository service based on Forgejo .

This tutorial assumes you already have a working Debian 12 virtual machine with a public IP.

Some useful links:

Install Forgejo#

  1. Update the system
sudo apt update
sudo apt -y upgrade
  1. Install dependencies (and some utilities)
sudo apt -y install vim tmux net-tools dnsutils git git-lfs postgresql postgresql-client nginx certbot
  1. Create a git user
sudo adduser --system --group --disabled-password --shell /bin/bash --home /opt/git git
  1. Download Forgejo from the release page
sudo wget -O /opt/git/forgejo https://codeberg.org/forgejo/forgejo/releases/download/v15.0.2/forgejo-15.0.2-linux-amd64
sudo chown git:git /opt/git/forgejo
sudo chmod +x /opt/git/forgejo
  1. Create required directories
sudo mkdir -p /etc/forgejo /var/lib/forgejo
sudo chown git:git /etc/forgejo /var/lib/forgejo
sudo chmod 750 /etc/forgejo /var/lib/forgejo
  1. Create the database
sudo -iu postgres -- psql -c "CREATE ROLE forgejo WITH LOGIN PASSWORD 'forgejo'"
sudo -iu postgres -- psql -c "CREATE DATABASE forgejo WITH OWNER forgejo"
  1. Download the Systemd service file
sudo wget -O /etc/systemd/system/forgejo.service https://codeberg.org/forgejo/forgejo/raw/branch/forgejo/contrib/systemd/forgejo.service
sudo sed -i -e 's|=/usr/local/bin/forgejo|=/opt/git/forgejo|' /etc/systemd/system/forgejo.service
sudo sed -i -e 's|HOME=/home/git|HOME=/opt/git|' /etc/systemd/system/forgejo.service
sudo systemctl daemon-reload
sudo systemctl enable forgejo.service
  1. Create the TLS certificate
sudo systemctl stop nginx.service
sudo certbot certonly --standalone -n --agree-tos --register-unsafely-without-email -d CHANGE_THIS.cloud.computecanada.ca
  1. Configure Nginx
sudo rm /etc/nginx/sites-enabled/default
sudo touch /etc/nginx/sites-available/forgejo
sudo ln -s /etc/nginx/sites-available/forgejo /etc/nginx/sites-enabled/forgejo
sudo vim /etc/nginx/sites-available/forgejo

Copy the following configuration inside /etc/nginx/sites-available/forgejo:

server {
    listen 80;

    return 308 https://$host$request_uri;
}

server {
    listen 443 ssl;

    ssl_certificate     /etc/letsencrypt/live/CHANGE_THIS.cloud.computecanada.ca/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/CHANGE_THIS.cloud.computecanada.ca/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;

    ssl_session_timeout 1d;
    ssl_session_cache shared:MozSSL:10m;

    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always;

    merge_slashes off;

    location / {
        client_max_body_size 0;
        proxy_read_timeout 2h;

        proxy_set_header Connection        $http_connection;
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_pass http://127.0.0.1:3000;
    }
}
  1. Reboot the virtual machine
sudo reboot
  1. Navigate to https://CHANGE_THIS.cloud.computecanada.ca to finish configuration