59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
|
# Forgejo (was: Gitea)
|
||
|
|
|
||
|
|
This deploys the Forgejo git hosting software on Fly.io.
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
1. Clone this repository
|
||
|
|
1. `fly launch`, follow the prompts
|
||
|
|
1. Select `n` when it asks if you want to deploy
|
||
|
|
1. Create a volume in a region of your choice: `fly volumes create data --size 50 --region ord`
|
||
|
|
1. Generate, and store securely, you secrets:
|
||
|
|
```shell
|
||
|
|
fly secrets set \
|
||
|
|
"GITEA__security__SECRET_KEY=$(openssl rand -hex 12)" \
|
||
|
|
"GITEA__security__INTERNAL_TOKEN=$(openssl rand -hex 12)"
|
||
|
|
```
|
||
|
|
1. For S3 storage you'll need to add two more secrets:
|
||
|
|
```shell
|
||
|
|
fly secrets set "GITEA__storage__MINIO_ACCESS_KEY_ID=[redacted]"
|
||
|
|
fly secrets set "GITEA__storage__MINIO_SECRET_ACCESS_KEY=[redacted]"
|
||
|
|
```
|
||
|
|
1. Deploy, `fly deploy --remote-only`
|
||
|
|
1. Setup DNS with your registrar, you must have either CNAME or A/AAAA records
|
||
|
|
set. See: https://fly.io/docs/app-guides/custom-domains-with-fly/
|
||
|
|
1. Create certificate for Fly's automatic TLS termination. `fly certs create git.example.com`
|
||
|
|
1. Opens an SSH session to the running container. `fly ssh console`
|
||
|
|
1. In the SSH session in the container, run: `su git` and then
|
||
|
|
```shell
|
||
|
|
gitea admin user create \
|
||
|
|
--username MYNAME \
|
||
|
|
--email MYEMAIL@example.com \
|
||
|
|
--admin \
|
||
|
|
--random-password \
|
||
|
|
--must-change-password
|
||
|
|
```
|
||
|
|
|
||
|
|
## Proxy the GUI to localhost
|
||
|
|
|
||
|
|
1. Forward container port 3000 to localhost:3000 `fly proxy 3000:3000`
|
||
|
|
|
||
|
|
## Get Connected using WireGuard (VPN)
|
||
|
|
|
||
|
|
1. Create a WireGuard peer with `fly wireguard create`
|
||
|
|
1. Setup WireGuard with generated config
|
||
|
|
1. `fly ips private` to get the IP of your Daemon
|
||
|
|
1. Set the `DOCKER_HOST` env variable using that IP:
|
||
|
|
```
|
||
|
|
export DOCKER_HOST=tcp://[fdaa:0:5d2:a7b:81:0:26d4:2]:2375
|
||
|
|
```
|
||
|
|
|
||
|
|
# Final Step
|
||
|
|
|
||
|
|
1. Delete the Docker Engine from your local system.
|
||
|
|
1. You probably want to scale your remote Daemon: `fly scale vm dedicated-cpu-2x`
|
||
|
|
|
||
|
|
# NOTES:
|
||
|
|
|
||
|
|
* https://blog.luketurner.org/posts/gitea-on-fly/
|