mash-playbook/docs/services/forgejo.md
M 20cd7971f3
Add Forgejo (#92)
* Create forgejo.md

* Update mash_servers

Add Forgejo

* Update requirements.yml

* Update releases.opml

* Update setup.yml

* Update supported-services.md

* Update requirements.yml

Fix typo

* Update mash_servers

Forgot "+"

* Fix Syntax Error

* Update Version for Requirement.yml
2023-09-06 15:53:44 +03:00

59 lines
2.1 KiB
Markdown

# Forgejo
[Forgejo](https://forgejo.org/) is a painless self-hosted Git service, an alternative fork to Gitea.
## Dependencies
This service requires the following other services:
- a [Postgres](postgres.md) database
- a [Traefik](traefik.md) reverse-proxy server
## Configuration
To enable this service, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:
```yaml
########################################################################
# #
# forgejo #
# #
########################################################################
forgejo_enabled: true
# Forgejo uses port 22 by default.
# We recommend that you move your regular SSH server to another port,
# and stick to this default.
#
# If you wish to use another port, uncomment the variable below
# and adjust the port as you see fit.
# forgejo_ssh_port: 222
forgejo_hostname: mash.example.com
forgejo_path_prefix: /forgejo
########################################################################
# #
# /forgejo #
# #
########################################################################
```
In the example configuration above, we configure the service to be hosted at `https://mash.example.com/forgejo`.
You can remove the `forgejo_path_prefix` variable definition, to make it default to `/`, so that the service is served at `https://mash.example.com/`.
## Usage
After installation, you should be able to access your new Forgejo instance at the configured URL (see above).
Going there, you'll be taken to the initial setup wizard, which will let you assign some paswords and other configuration.
## Recommended other services
You may also wish to look into [Woodpecker CI](woodpecker-ci.md), which can integrate nicely with Forgejo.