2023-01-17 21:43:32 +01:00
---
gitea: none
include_toc: true
---
# forgejo
2023-08-02 09:26:54 +02:00
## Synopsis
2023-01-17 21:43:32 +01:00
Forgejo, a community managed lightweight code hosting solution.
2023-08-02 09:26:54 +02:00
[More informations about this software. ](https://forgejo.org/ )
2023-01-17 21:43:32 +01:00
2023-08-02 09:26:54 +02:00
## Basic variables
2023-08-01 14:34:26 +02:00
2023-08-02 09:26:54 +02:00
### Général
2023-08-01 14:34:26 +02:00
2023-08-02 09:26:54 +02:00
#### Reverse proxy
2023-08-01 14:34:26 +02:00
2023-08-02 09:26:54 +02:00
##### Point d'entrée des clients
This a family is a leadership.
| Parameter | Comments |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
| ** [general.revprox.revprox_client.revprox_client_external_domainnames ](dictionaries/21_revprox_client.xml )**< br /> mandatory, multiple< br /> **Type:** [`domainname` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Nom de domaine exterieur du serveur.< br /> **Example:** service.example.net |
| ** [general.revprox.revprox_client.revprox_client_location ](dictionaries/21_revprox_client.xml )**< br /> mandatory< br /> **Type:** [`filename` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Nom de l'arborescence racine du site. |
#### Forgejo
Git forge Forgejo.
| Parameter | Comments |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|
| ** [general.forgejo.forgejo_title ](dictionaries/31_forgejo.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Titre de la forge.< br /> **Default:** Forgejo : Au-delà du développement. Nous forgeons. |
| ** [general.forgejo.forgejo_mail_sender ](dictionaries/31_forgejo.xml )**< br /> mandatory< br /> **Type:** [`mail` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Les courriels sont envoyés à partir de cet adresse.< br /> **Example:** admin@example.net |
## Variables for expert
### Général
#### Reverse proxy
##### Point d'entrée des clients
This a family is a leadership.
| Parameter | Comments |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
| ** [general.revprox.revprox_client.revprox_client_max_body_size ](dictionaries/21_revprox_client.xml )**< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Taille maximum du corps. |
#### PostgreSQL
| Parameter | Comments |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
| ** [general.postgresql.pg_client_username ](dictionaries/23_postgresql.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Client username.< br /> **Default:** *calculated* |
| ** [general.postgresql.pg_client_password ](dictionaries/23_postgresql.xml )**< br /> mandatory< br /> **Type:** [`password` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Client password.< br /> **Default:** *calculated* |
| ** [general.postgresql.pg_client_database ](dictionaries/23_postgresql.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Client database.< br /> **Default:** *calculated* |
#### Redis
| Parameter | Comments |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
| ** [general.redis.redis_client_username ](dictionaries/23_redis.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Nom d'utilisateur.< br /> **Default:** *calculated* |
| ** [general.redis.redis_client_password ](dictionaries/23_redis.xml )**< br /> mandatory< br /> **Type:** [`password` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | Mot de passe de connexion.< br /> **Default:** *calculated* |
#### OAuth2 client
| Parameter | Comments |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
| ** [general.oauth2_client.oauth2_client_name ](dictionaries/31_forgejo.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 client name.< br /> **Default:** Forge< br /> **Example:** example |
| ** [general.oauth2_client.oauth2_client_description ](dictionaries/31_forgejo.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 client description.< br /> **Default:** Forge logiciel Forgejo< br /> **Example:** Example description |
| ** [general.oauth2_client.oauth2_client_login ](dictionaries/30_oauth2_client.xml )**< br /> **Type:** [`web_address` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 URL to valid login.< br /> **Default:** *calculated* |
##### external
2023-08-01 14:34:26 +02:00
2023-08-02 09:26:54 +02:00
| Parameter | Comments |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| ** [general.oauth2_client.external.oauth2_client_external ](dictionaries/31_forgejo.xml )**< br /> mandatory, multiple< br /> **Type:** [`web_address` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 client external.< br /> **Default:** *calculated* |
| ** [general.oauth2_client.external.oauth2_client_family ](dictionaries/30_oauth2_client.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 family.< br /> **Default:** users |
| Parameter | Comments |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
| ** [general.oauth2_client.oauth2_client_category ](dictionaries/31_forgejo.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 category.< br /> **Default:** Développement |
| ** [general.oauth2_client.oauth2_client_logo ](dictionaries/31_forgejo.xml )**< br /> mandatory< br /> **Type:** [`string` ](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable ) | OAuth2 logo.< br /> **Default:** silique_note.png |
## Requirements services
- **LocalDNS**
- Journald
- **SMTP**
- **ReverseProxy**
- **Postgresql**
- **Redis**
- **OAuth2**
**bold**: provider is mandatory
## Example
Zone names are provided as examples. Think about adapting with the value of provider_zone in configuration file.
2023-08-01 14:34:26 +02:00
```
forgejo:
applicationservice: forgejo
zones_name:
- localdns
- reverseproxy
- smtp
- redis
- oauth2
- postgresql
2023-08-02 09:26:54 +02:00
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
general.forgejo.forgejo_mail_sender: admin@example.net
2023-08-01 14:34:26 +02:00
```
2023-01-17 21:43:32 +01:00
## Dependances
2023-06-29 18:56:46 +02:00
- [base-fedora-38 ](../base-fedora-38/README.md )
2023-01-17 21:43:32 +01:00
- [base-fedora ](../base-fedora/README.md )
- [systemd ](../systemd/README.md )
- [base-machine ](../base-machine/README.md )
- [base ](../base/README.md )
- [dns-local ](../dns-local/README.md )
2023-02-14 14:24:16 +01:00
- [pki-tls ](../pki-tls/README.md )
2023-06-29 18:56:46 +02:00
- [journald ](../journald/README.md )
2023-07-31 18:41:59 +02:00
- [resolved ](../resolved/README.md )
2023-01-17 21:43:32 +01:00
- [postgresql-client ](../postgresql-client/README.md )
- [reverse-proxy-client ](../reverse-proxy-client/README.md )
- [relay-mail-client ](../relay-mail-client/README.md )
- [redis-client ](../redis-client/README.md )
2023-06-29 18:56:46 +02:00
- [redis-common ](../redis-common/README.md )
2023-01-17 21:43:32 +01:00
- [oauth2-client ](../oauth2-client/README.md )
## Used by
2023-06-29 18:56:46 +02:00
[gitea ](../gitea/README.md )
2023-02-14 14:43:41 +01:00
[All applications services for this dataset. ](../README.md )
