docker-samples/forgejo_cloudflare/README.md
2024-11-01 22:13:22 -06:00

26 lines
1.1 KiB
Markdown

# Forgejo via. Cloudflare Tunnel
This example is a quick start to running an instance of the excellent Forgejo git server under Docker.
* Publicly exposed via. Cloudflare Tunnel
* Pre-configured Github Action-style Runners
* Mail delivery (assuming Mailgun, but adjustable to any SMTP server)
* Pre-configured (no installation wizard) including admin account
See the full blog post on this here:
https://www.straybits.ca/2014/self-hosted-git-server/
## Steps:
0. Create a Tunnel on Cloudflare and grab the Tunnel Token
1. Copy `docker-compose.yml` and `.env` to a new folder
2. Update variables in `.env` making sure to generate random secrets for the various secrets marked with `##REQUIRED##`
3. Make sure to update the `yourdomain.com` to match your name
4. Add end points to your Tunnel
1. `git.yourdomain.com` >> `http://server:3000`
2. `git-ssh.yourdomain.com` >> `ssh://server:22`
5. `docker compose up -d`
6. Wait...
7. Wait a bit more
8. Visit `https://git.yourdomain.com` in your browser and login with the admin credentials in your `.env` file.
9. Verify settings. (i.e. do you want to disable user signups, etc.)