gitea/README.md

## Prerequisites

Before you begin, you will need:

- A server running Ubuntu 18.04 or later
- `sudo` privileges
- An internet connection

## Steps

1. Update the repository cache:

`sudo apt update`


2. Install the necessary packages:

`sudo apt install -y nginx-light certbot python3-certbot-nginx docker.io`


3. Add the current user to the `docker` group and switch to this group:

`sudo usermod -a -G docker $USER newgrp docker`


4. Initialize Docker Swarm mode if it has not yet been initialized:

`docker swarm init || true`


5. Deploy the Gitea application using Docker Swarm:

`docker stack deploy -c stack.yaml gitea`

Note: The `stack.yaml` file contains the configuration for the Gitea application, including the Docker image to use, the ports to expose, and any environment variables to set.


6. Change `GITEA_HOSTNAME` and `EMAIL` to your own values and then run `setup_nginx.sh` script:

`bash setup_nginx.sh`

It will generate nginx config and issue ssl certificate for your Gitea.

7. After that you can go to `$GITEA_HOSTNAME` URL and finish the installstion. At the bottom of install page, don't forget to create 
an administrator account.

8. Go to `$GITEA_HOSTNAME/admin/runners`, press `Create new runner` button, copy registration token from there and incert it into `.env` file as `GITEA_TOKEN` parameter.

9. Run `setup_act_runner` script, which will install CI agent to your node. You will se it on `$GITEA_HOSTNAME/admin/runners` page.