spadinastan/services/code-forge/README.md

# Code Forge

Forgejo instance serving https://forge.karnov.club.

## Usage

### Starting / restarting

```bash
FORGEJO_ROOT=.. FORGEJO_RUNNER_ROOT=... FORGEJO_RUNNER_CONFIG=... ./start.sh
```

`FORGEJO_ROOT` should be a directory with read+write access by the container user, this is where application data will
get stored.

`FORGEJO_RUNNER_ROOT` should also be read+write accessible and will be where the runner stores data.

`FORGEJO_RUNNER_CONFIG` should point to the runner configuration YAML file. If undefined, the default included with the scripts is used.

Calling the `start.sh` script will replace the containers if they already exists.

### Stopping

```bash
./stop.sh
```

## Networking

| Port | Notes |
|---|---|
|`3000`|Web listening port|