diff --git a/seed/README.ExternalDNS.md b/seed/README.ExternalDNS.md
new file mode 100644
index 00000000..6f811240
--- /dev/null
+++ b/seed/README.ExternalDNS.md
@@ -0,0 +1,29 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# ExternalDNS
+
+## Synopsis
+
+DNS forwarder for all DNS zones.
This provider is able to answer query for external and internal domain name.
+
+## Variables
+
+| Parameter | Comment |
+|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------|
+| **ExternalDNS:authority_zones**
multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Local DNS server can export own authority zones. |
+
+## Provider
+
+[unbound](unbound/README.md): Unbound, a validating, recursive, caching DNS resolver.
+
+## Suppliers
+
+- [postfix-relay](postfix-relay/README.md): Postfix, the mail server, as relay.
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [znc](znc/README.md): ZNC, a bouncer IRC.
+- [nsd-local](nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
diff --git a/seed/README.IMAP.md b/seed/README.IMAP.md
new file mode 100644
index 00000000..ee5ae507
--- /dev/null
+++ b/seed/README.IMAP.md
@@ -0,0 +1,23 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# IMAP
+
+## Synopsis
+
+IMAP server connexion.
+
+## Variables
+
+
+## Provider
+
+[dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+
+## Supplier
+
+[roundcube](roundcube/README.md): Roundcube, a webmail.
diff --git a/seed/README.Journald.md b/seed/README.Journald.md
new file mode 100644
index 00000000..c0b93ae4
--- /dev/null
+++ b/seed/README.Journald.md
@@ -0,0 +1,54 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Journald
+
+## Synopsis
+
+Concentrate journal messages on one host.
+
+## Variables
+
+| Parameter | Comment |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
+| **Journald:message**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Message to exclude for *supplier name*. |
+| **Journald:service**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Log from this service to exclude for *supplier name*. |
+| **Journald:function**
multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Function use to compare message (if not defined, exlude same message) for *supplier name*. |
+
+## Provider
+
+[vector](vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [nginx-static](nginx-static/README.md): Nginx as static web site.
+- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [postgresql](postgresql/README.md): Postgresql, a database.
+- [postfix-relay](postfix-relay/README.md): Postfix, the mail server, as relay.
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [vector](vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [unbound](unbound/README.md): Unbound, a validating, recursive, caching DNS resolver.
+- [redis](redis/README.md): Redis, an in-memory data structure store.
+- [loki](loki/README.md): Loki, a log aggregation platform.
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [nsd](nsd/README.md): NSD, an authoritative DNS name server.
+- [speedtest-rs](speedtest-rs/README.md): Speedtest-rs, a very lightweight Speedtest.
+- [nginx-reverse-proxy](nginx-reverse-proxy/README.md): Nginx as reverse proxy.
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [znc](znc/README.md): ZNC, a bouncer IRC.
+- [vaultwarden](vaultwarden/README.md): Vaultwarden, a password manager.
+- [prometheus](prometheus/README.md): Prometheus, an event monitoring.
+- [mariadb](mariadb/README.md): MariaDB, a relational database.
+- [nsd-local](nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [lemonldap](lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [openldap](openldap/README.md): OpenLDAP, the LDAP server.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.LDAP.md b/seed/README.LDAP.md
new file mode 100644
index 00000000..bae474ac
--- /dev/null
+++ b/seed/README.LDAP.md
@@ -0,0 +1,34 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# LDAP
+
+## Synopsis
+
+Automaticly create account and connexion to a LDAP server.
+
+## Variables
+
+| Parameter | Comment |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------|
+| **LDAP:family**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | LDAP family name for *supplier name*. |
+| **LDAP:dn**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | LDAP account DN for *supplier name*. |
+| **LDAP:password**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | LDAP passowrd for *supplier name*. |
+| **LDAP:base_dn**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | LDAP base DN for *supplier name*. |
+
+## Provider
+
+[openldap](openldap/README.md): OpenLDAP, the LDAP server.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [lemonldap](lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
diff --git a/seed/README.LMTP.md b/seed/README.LMTP.md
new file mode 100644
index 00000000..b4af1dca
--- /dev/null
+++ b/seed/README.LMTP.md
@@ -0,0 +1,27 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# LMTP
+
+## Synopsis
+
+LMTP remote server.
A service needs send email with LMTP protocol.
+
+## Variables
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
+| **LMTP:criteria**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domain name allowes to send email with LMTP protocol for *supplier name*. |
+
+## Provider
+
+[postfix-relay](postfix-relay/README.md): Postfix, the mail server, as relay.
+
+## Suppliers
+
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
diff --git a/seed/README.LocalDNS.md b/seed/README.LocalDNS.md
new file mode 100644
index 00000000..3aa6c894
--- /dev/null
+++ b/seed/README.LocalDNS.md
@@ -0,0 +1,48 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# LocalDNS
+
+## Synopsis
+
+DNS forwarder for local domain name.
+
+## Variables
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|
+| **LocalDNS:DNSSEC_DS**
multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | DNSSEC DS informations. |
+
+## Provider
+
+[nsd-local](nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [nginx-static](nginx-static/README.md): Nginx as static web site.
+- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [postgresql](postgresql/README.md): Postgresql, a database.
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [vector](vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [redis](redis/README.md): Redis, an in-memory data structure store.
+- [loki](loki/README.md): Loki, a log aggregation platform.
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [nsd](nsd/README.md): NSD, an authoritative DNS name server.
+- [speedtest-rs](speedtest-rs/README.md): Speedtest-rs, a very lightweight Speedtest.
+- [nginx-reverse-proxy](nginx-reverse-proxy/README.md): Nginx as reverse proxy.
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [vaultwarden](vaultwarden/README.md): Vaultwarden, a password manager.
+- [prometheus](prometheus/README.md): Prometheus, an event monitoring.
+- [mariadb](mariadb/README.md): MariaDB, a relational database.
+- [nsd-local](nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [lemonldap](lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [openldap](openldap/README.md): OpenLDAP, the LDAP server.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.Loki.md b/seed/README.Loki.md
new file mode 100644
index 00000000..697c07aa
--- /dev/null
+++ b/seed/README.Loki.md
@@ -0,0 +1,23 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Loki
+
+## Synopsis
+
+Remote loki client.
+
+## Variables
+
+
+## Provider
+
+[loki](loki/README.md): Loki, a log aggregation platform.
+
+## Supplier
+
+[vector](vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
diff --git a/seed/README.MariaDB.md b/seed/README.MariaDB.md
new file mode 100644
index 00000000..c65dc8d9
--- /dev/null
+++ b/seed/README.MariaDB.md
@@ -0,0 +1,28 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# MariaDB
+
+## Synopsis
+
+Automaticly create account and connexion to a MariaDB server.
+
+## Variables
+
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|
+| **MariaDB:username**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | MariaDB user name for *supplier name*. |
+| **MariaDB:password**
mandatory
**Type:** [`secret`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | MariaDB password for *supplier name*. |
+| **MariaDB:database**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | MariaDB database name for *supplier name*. |
+
+## Provider
+
+[mariadb](mariadb/README.md): MariaDB, a relational database.
+
+## Supplier
+
+[piwigo](piwigo/README.md): Piwigo, a photo management software.
diff --git a/seed/README.OAuth2.md b/seed/README.OAuth2.md
new file mode 100644
index 00000000..039b06d7
--- /dev/null
+++ b/seed/README.OAuth2.md
@@ -0,0 +1,45 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# OAuth2
+
+## Synopsis
+
+Remote clients needing to verify OAuth2 account.
+
+## Variables
+
+| Parameter | Comment |
+|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
+| **OAuth2:name**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote name for *supplier name*. |
+| **OAuth2:description**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote description for *supplier name*. |
+| **OAuth2:login**
**Type:** [`web_address`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote URL to login for *supplier name*. |
+| **OAuth2:external**
mandatory, multiple
**Type:** [`web_address`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote external for *supplier name*. |
+| **OAuth2:family**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote family for *supplier name*. |
+| **OAuth2:category**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remode category for *supplier name*. |
+| **OAuth2:logo**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Logo for *supplier name*. |
+| **OAuth2:client_id**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote client id for *supplier name*. |
+| **OAuth2:secret**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote secret for *supplier name*. |
+| **OAuth2:token_signature_algo**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 token signature algorithm for *supplier name*.
**Choices:**
- `HS512`
- `RS256` |
+| **OAuth2:external_domain**
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 server domain name. |
+
+## Provider
+
+[lemonldap](lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.Postgresql.md b/seed/README.Postgresql.md
new file mode 100644
index 00000000..7c3ea8a9
--- /dev/null
+++ b/seed/README.Postgresql.md
@@ -0,0 +1,36 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Postgresql
+
+## Synopsis
+
+Automaticly create account and connexion to a PostgreSQL server.
+
+## Variables
+
+| Parameter | Comment |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|
+| **Postgresql:username**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Postgresql username for *supplier name*. |
+| **Postgresql:password**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Postgresql password for *supplier name*. |
+| **Postgresql:database**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Postgresql database name for *supplier name*. |
+
+## Provider
+
+[postgresql](postgresql/README.md): Postgresql, a database.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [vaultwarden](vaultwarden/README.md): Vaultwarden, a password manager.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.Prometheus.md b/seed/README.Prometheus.md
new file mode 100644
index 00000000..f99ad52c
--- /dev/null
+++ b/seed/README.Prometheus.md
@@ -0,0 +1,19 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Prometheus
+
+## Synopsis
+
+Automaticly configure Prometheus exporter.
+
+## Variables
+
+
+## Provider
+
+[prometheus](prometheus/README.md): Prometheus, an event monitoring.
diff --git a/seed/README.Redis.md b/seed/README.Redis.md
new file mode 100644
index 00000000..42e9110e
--- /dev/null
+++ b/seed/README.Redis.md
@@ -0,0 +1,33 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Redis
+
+## Synopsis
+
+Automaticly create account and connexion to a Redis server.
+
+## Variables
+
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
+| **Redis:username**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Redis user name for *supplier name*. |
+| **Redis:password**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Redis password for *supplier name*. |
+| **Redis:index**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Redis database index.
Only index 0 is allowed, Redis project discourage to use the server with several database. |
+
+## Provider
+
+[redis](redis/README.md): Redis, an in-memory data structure store.
+
+## Suppliers
+
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.ReverseProxy.md b/seed/README.ReverseProxy.md
new file mode 100644
index 00000000..f3412f9b
--- /dev/null
+++ b/seed/README.ReverseProxy.md
@@ -0,0 +1,44 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# ReverseProxy
+
+## Synopsis
+
+Automaticly register to service to a reverse proxy server.
+
+## Variables
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **ReverseProxy:external**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External domain name for *supplier name*. |
+| **ReverseProxy:location**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to redirect for *supplier name*.
URL relative (sans le nom de domaine) redirigée pour l'adresse définie dans la variable ci-dessus (exemple "/mail"). |
+| **ReverseProxy:max_body_size**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Body size max for *supplier name*. |
+| **ReverseProxy:websocket**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The entry point is a websocket for *supplier name*.
**Default:** [True] |
+| **ReverseProxy:url**
mandatory
**Type:** [`web_address`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Internal URL for *supplier name*. |
+| **ReverseProxy:http**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The website is in HTTP for *supplier name*.
**Default:** True |
+
+## Provider
+
+[nginx-reverse-proxy](nginx-reverse-proxy/README.md): Nginx as reverse proxy.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [nginx-static](nginx-static/README.md): Nginx as static web site.
+- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [speedtest-rs](speedtest-rs/README.md): Speedtest-rs, a very lightweight Speedtest.
+- [roundcube](roundcube/README.md): Roundcube, a webmail.
+- [vaultwarden](vaultwarden/README.md): Vaultwarden, a password manager.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [lemonldap](lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.SMTP.md b/seed/README.SMTP.md
new file mode 100644
index 00000000..61ad9962
--- /dev/null
+++ b/seed/README.SMTP.md
@@ -0,0 +1,37 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# SMTP
+
+## Synopsis
+
+Automaticly create a SMTP relay account and authorize sending email.
A service needs send email with SMTP protocol, so an account is created and SMTP relay accept sending mail by this account.
+
+## Variables
+
+| Parameter | Comment |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
+| **SMTP:username**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | User account to send email for *supplier name*. |
+| **SMTP:password**
mandatory
**Type:** [`secret`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Password to send email for *supplier name*. |
+
+## Provider
+
+[postfix-relay](postfix-relay/README.md): Postfix, the mail server, as relay.
+
+## Suppliers
+
+- [odoo](odoo/README.md): Odoo, an ERP and CRM.
+- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [mailman](mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [peertube](peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](piwigo/README.md): Piwigo, a photo management software.
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [vaultwarden](vaultwarden/README.md): Vaultwarden, a password manager.
+- [nextcloud](nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [lemonldap](lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo.
diff --git a/seed/README.Vector.md b/seed/README.Vector.md
new file mode 100644
index 00000000..b9ec073a
--- /dev/null
+++ b/seed/README.Vector.md
@@ -0,0 +1,22 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Vector
+
+## Synopsis
+
+Collect observability data from another Vector instance.
+
+## Variables
+
+| Parameter | Comment |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|
+| **Vector:address**
**Type:** [`ip`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Send Journal on this IP address.
Vector must listen on this address, clients are configured to use this destination IP. |
+
+## Provider
+
+[vector](vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
diff --git a/seed/README.md b/seed/README.md
index e13feb25..0acb9bea 100644
--- a/seed/README.md
+++ b/seed/README.md
@@ -1,6 +1,6 @@
# Application services
-- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (Submission and IMAP)
+- [dovecot](dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission)
- [forgejo](forgejo/README.md): Forgejo, a community managed lightweight code hosting solution
- [gitea](gitea/README.md): Transitional package for Gitea to Forgejo
- [grafana](grafana/README.md): Grafana is an analytics and interactive visualization web application
@@ -72,55 +72,20 @@
- [reverse-proxy-client](reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server
- [systemd](systemd/README.md): Systemd, a system and service manager
-# Providers and suppliers
+# Providers
-- ExternalDNS:
- - Provider: [unbound](unbound/README.md)
- - Suppliers:
- - [dns-external](dns-external/README.md)
- - [nsd-local](nsd-local/README.md)
-- Host:
- - Provider: [host-systemd-machined](host-systemd-machined/README.md)
- - Supplier: [provider-systemd-machined](provider-systemd-machined/README.md)
-- IMAP:
- - Provider: [dovecot](dovecot/README.md)
- - Supplier: [imap-client](imap-client/README.md)
-- Journald:
- - Provider: [journald_remote](journald_remote/README.md)
- - Supplier: [journald](journald/README.md)
-- LDAP:
- - Provider: [openldap](openldap/README.md)
- - Supplier: [ldap-client](ldap-client/README.md)
-- LMTP:
- - Provider: [postfix-lmtp-relay](postfix-lmtp-relay/README.md)
- - Supplier: [relay-lmtp-client](relay-lmtp-client/README.md)
-- LocalDNS:
- - Provider: [nsd-local](nsd-local/README.md)
- - Supplier: [dns-local](dns-local/README.md)
-- Loki:
- - Provider: [loki](loki/README.md)
- - Supplier: [vector](vector/README.md)
-- MariaDB:
- - Provider: [mariadb](mariadb/README.md)
- - Supplier: [mariadb-client](mariadb-client/README.md)
-- OAuth2:
- - Provider: [lemonldap](lemonldap/README.md)
- - Supplier: [oauth2-client](oauth2-client/README.md)
-- Postgresql:
- - Provider: [postgresql](postgresql/README.md)
- - Supplier: [postgresql-client](postgresql-client/README.md)
-- Prometheus:
- - Provider: [prometheus](prometheus/README.md)
- - Supplier: [host-systemd-machined](host-systemd-machined/README.md)
-- Redis:
- - Provider: [redis](redis/README.md)
- - Supplier: [redis-client](redis-client/README.md)
-- ReverseProxy:
- - Provider: [nginx-reverse-proxy](nginx-reverse-proxy/README.md)
- - Supplier: [reverse-proxy-client](reverse-proxy-client/README.md)
-- SMTP:
- - Provider: [postfix-relay](postfix-relay/README.md)
- - Supplier: [relay-mail-client](relay-mail-client/README.md)
-- Vector:
- - Provider: [vector](vector/README.md)
- - Supplier: [host-systemd-machined](host-systemd-machined/README.md)
+- [ExternalDNS](README.ExternalDNS.md): DNS forwarder for all DNS zones.
+- [IMAP](README.IMAP.md): IMAP server connexion.
+- [Journald](README.Journald.md): Concentrate journal messages on one host.
+- [LDAP](README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [LMTP](README.LMTP.md): LMTP remote server.
+- [LocalDNS](README.LocalDNS.md): DNS forwarder for local domain name.
+- [Loki](README.Loki.md): Remote loki client.
+- [MariaDB](README.MariaDB.md): Automaticly create account and connexion to a MariaDB server.
+- [OAuth2](README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [Postgresql](README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [Prometheus](README.Prometheus.md): Automaticly configure Prometheus exporter.
+- [Redis](README.Redis.md): Automaticly create account and connexion to a Redis server.
+- [ReverseProxy](README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [SMTP](README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [Vector](README.Vector.md): Collect observability data from another Vector instance.
diff --git a/seed/apache/README.md b/seed/apache/README.md
index 661853c5..d7004c61 100644
--- a/seed/apache/README.md
+++ b/seed/apache/README.md
@@ -3,35 +3,34 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# apache
## Synopsis
-Apache as web server.
-[Software's website.](https://httpd.apache.org/)
+[Apache as web server.](https://httpd.apache.org/)
## Variables for expert
-### Général
+### General
#### Apache
-Paramètrage avancé du serveur web Apache.
+Advance Apache web server settings.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
-| **[general.apache.apache_timeout](dictionaries/20_web.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Temps d'attente des entrées/sorties avant de considérer qu'une requête a échoué.
Temps en secondes.
**Default:** 300 |
-| **[general.apache.apache_keepalive](dictionaries/20_web.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autoriser les connexions persistantes.
**Default:** True |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
+| **[general.apache.apache_timeout](dictionaries/20_web.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Amount of time the server will wait for certain events before failing a request.
Time in seconds.
**Default:** 300 |
+| **[general.apache.apache_keepalive](dictionaries/20_web.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Enables HTTP persistent connections.
**Default:** True |
## Dependances
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
## Used by
[nextcloud](../nextcloud/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/apache/dictionaries/20_web.xml b/seed/apache/dictionaries/20_web.xml
index 7a2aaf02..c885b4c4 100644
--- a/seed/apache/dictionaries/20_web.xml
+++ b/seed/apache/dictionaries/20_web.xml
@@ -15,11 +15,11 @@
apache
-
-
+
+
300
-
+
diff --git a/seed/base-debian-bullseye/README.md b/seed/base-debian-bullseye/README.md
index ec2829ee..32941e54 100644
--- a/seed/base-debian-bullseye/README.md
+++ b/seed/base-debian-bullseye/README.md
@@ -3,29 +3,28 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-debian-bullseye
## Synopsis
-Base information of a Debian Bulleye server.
-[Software's website.](https://www.debian.org/)
+[Base information of a Debian Bulleye server.](https://www.debian.org/)
## Dependances
-- [base-debian](../base-debian/README.md)
- - [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-debian](../base-debian/README.md): Base information of a Debian server.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
- [odoo](../odoo/README.md)
- [mailman](../mailman/README.md)
- [lemonldap](../lemonldap/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-debian/README.md b/seed/base-debian/README.md
index 455c6d1e..fb34da09 100644
--- a/seed/base-debian/README.md
+++ b/seed/base-debian/README.md
@@ -3,26 +3,25 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-debian
## Synopsis
-Base information of a Debian server.
-[Software's website.](https://www.debian.org/)
+[Base information of a Debian server.](https://www.debian.org/)
## Dependances
-- [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
[base-debian-bullseye](../base-debian-bullseye/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-fedora-35/README.md b/seed/base-fedora-35/README.md
index a8164be4..6add3e38 100644
--- a/seed/base-fedora-35/README.md
+++ b/seed/base-fedora-35/README.md
@@ -3,27 +3,26 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-fedora-35
## Synopsis
-Base information of a Fedora 35.
-[Software's website.](https://getfedora.org/)
+[Base information of a Fedora 35.](https://getfedora.org/)
## Dependances
-- [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
[postfix-relay](../postfix-relay/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-fedora-36/README.md b/seed/base-fedora-36/README.md
index 03ef07a1..a5b172f3 100644
--- a/seed/base-fedora-36/README.md
+++ b/seed/base-fedora-36/README.md
@@ -3,24 +3,25 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-fedora-36
## Synopsis
-Base information of a Fedora 36.
-[Software's website.](https://getfedora.org/)
+[Base information of a Fedora 36.](https://getfedora.org/)
## Dependances
-- [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
@@ -32,5 +33,3 @@ Base information of a Fedora 36.
- [vaultwarden](../vaultwarden/README.md)
- [mariadb](../mariadb/README.md)
- [nextcloud](../nextcloud/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-fedora-37/README.md b/seed/base-fedora-37/README.md
index d8472268..656eab52 100644
--- a/seed/base-fedora-37/README.md
+++ b/seed/base-fedora-37/README.md
@@ -3,24 +3,25 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-fedora-37
## Synopsis
-Base information of a Fedora 37.
-[Software's website.](https://getfedora.org/)
+[Base information of a Fedora 37.](https://getfedora.org/)
## Dependances
-- [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
@@ -30,5 +31,3 @@ Base information of a Fedora 37.
- [nsd](../nsd/README.md)
- [nginx-reverse-proxy](../nginx-reverse-proxy/README.md)
- [openldap](../openldap/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-fedora-38/README.md b/seed/base-fedora-38/README.md
index 1e0f4356..0103d010 100644
--- a/seed/base-fedora-38/README.md
+++ b/seed/base-fedora-38/README.md
@@ -3,24 +3,25 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-fedora-38
## Synopsis
-Base information of a Fedora 38.
-[Software's website.](https://getfedora.org/)
+[Base information of a Fedora 38.](https://getfedora.org/)
## Dependances
-- [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
@@ -31,5 +32,3 @@ Base information of a Fedora 38.
- [loki](../loki/README.md)
- [forgejo](../forgejo/README.md)
- [prometheus](../prometheus/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-fedora/README.md b/seed/base-fedora/README.md
index e532760d..89b9f615 100644
--- a/seed/base-fedora/README.md
+++ b/seed/base-fedora/README.md
@@ -3,23 +3,24 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-fedora
## Synopsis
-Base information of a Fedora.
-[Software's website.](https://getfedora.org/)
+[Base information of a Fedora.](https://getfedora.org/)
## Dependances
-- [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
@@ -27,5 +28,3 @@ Base information of a Fedora.
- [base-fedora-35](../base-fedora-35/README.md)
- [base-fedora-38](../base-fedora-38/README.md)
- [base-fedora-37](../base-fedora-37/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base-machine/README.md b/seed/base-machine/README.md
index 1852ce7e..afa89d45 100644
--- a/seed/base-machine/README.md
+++ b/seed/base-machine/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base-machine
## Synopsis
@@ -21,12 +23,10 @@ Base information for a machine.
## Dependances
-- [base](../base/README.md)
-- [dns-local](../dns-local/README.md)
-- [pki-tls](../pki-tls/README.md)
+- [base](../base/README.md): Base of all application services.
+- [dns-local](../dns-local/README.md): DNS client with access to local zones.
+- [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
## Used by
[systemd](../systemd/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base/README.md b/seed/base/README.md
index b8308440..e95b57d2 100644
--- a/seed/base/README.md
+++ b/seed/base/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# base
## Synopsis
@@ -13,5 +15,3 @@ Base of all application services.
- [host-systemd-machined](../host-systemd-machined/README.md)
- [base-machine](../base-machine/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/base/dictionaries/00_base.xml b/seed/base/dictionaries/00_base.xml
index 031667cf..2ccdace8 100644
--- a/seed/base/dictionaries/00_base.xml
+++ b/seed/base/dictionaries/00_base.xml
@@ -1,8 +1,10 @@
-
+
+
+
diff --git a/seed/dns-external/README.md b/seed/dns-external/README.md
index 56cb8084..7f5d073e 100644
--- a/seed/dns-external/README.md
+++ b/seed/dns-external/README.md
@@ -3,33 +3,17 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# dns-external
## Synopsis
DNS client with resolution on all zones (especially outside).
-
-## Variables
-
-### Général
-
-#### network
-
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|
-| **[general.network.dns_is_only_local](dictionaries/14_dns-external.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** False |
-
-
## Used by
- [postfix-relay](../postfix-relay/README.md)
- [peertube](../peertube/README.md)
- [unbound](../unbound/README.md)
- [znc](../znc/README.md)
-
-## Provider
-
-[unbound](../unbound/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/dns-external/dictionaries/14_dns-external.xml b/seed/dns-external/dictionaries/14_dns-external.xml
index 06f3b086..2758fb93 100644
--- a/seed/dns-external/dictionaries/14_dns-external.xml
+++ b/seed/dns-external/dictionaries/14_dns-external.xml
@@ -2,10 +2,10 @@
-
+
False
-
+
diff --git a/seed/dns-local/README.md b/seed/dns-local/README.md
index 78203c7b..4cd0191d 100644
--- a/seed/dns-local/README.md
+++ b/seed/dns-local/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# dns-local
## Synopsis
@@ -12,9 +14,3 @@ DNS client with access to local zones.
## Used by
[base-machine](../base-machine/README.md)
-
-## Provider
-
-[nsd-local](../nsd-local/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/dovecot/README.md b/seed/dovecot/README.md
index ed2d5999..640e3ff2 100644
--- a/seed/dovecot/README.md
+++ b/seed/dovecot/README.md
@@ -3,73 +3,67 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# dovecot
## Synopsis
-Postfix and Dovecot as mail servers (Submission and IMAP).
-[Software's website.](https://www.dovecot.org/)
+[Postfix and Dovecot as mail servers (IMAP and submission).](https://www.dovecot.org/)
+
+This application service provides email server. Two servers are used: Dovecot as IMAP server and Postfix as submission server. In addition, an auto-detection file of the email configuration is set up.
## Basic variables
-### Général
+### General
#### Mail configuration
+Configure IMAP servers and submission to access email accounts and send emails.
+
##### Mail domain
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------|
-| **[general.mail.domain.mail_domains](dictionaries/31_dovecot.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domaine de courriel géré localement.
**Example:** example.net |
-| **[general.mail.domain.imap_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domaine exterieur d'accès au serveur IMAP.
**Example:** imap.example.net |
-| **[general.mail.domain.submission_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domaine exterieur d'accès au serveur submission.
**Example:** submission.example.net |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **[general.mail.domain.mail_domains](dictionaries/31_dovecot.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Final destination email address.
These domain names are the domain names for emails (user@*example.net*) and for auto configuration of email clients (https://*example.net*/.well-known/autoconfig/mail/config-v1.1.xml).
**Example:** example.net |
+| **[general.mail.domain.imap_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External IMAP server address.
Matches TLS connection’s SNI name, if it’s sent by the client. For some email clients, use in DNS configuration a line like "_submissions._tcp IN SRV 1 587 *imap.example.net*.".
**Example:** imap.example.net |
+| **[general.mail.domain.submission_domainname](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External submission server address.
Matches TLS connection’s SNI name, if it’s sent by the client. For some email clients, add in DNS configuration a line like "_imaps._tcp IN SRV 0 1 993 *submission.example.net*.".
**Example:** submission.example.net |
+
+| Parameter | Comments |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **[general.mail.mail_crt_provider](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type of certificate autority signing external IMAP and submission domain certificates.
The certificate can be self-signed (therefore invalid by default for the client) or obtained via the Let's Encrypt service (generally valid for the client).
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
## Variables
-### Général
+### General
-#### Mail configuration
-
-##### Mail domain
-
-This family is a leadership.
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.mail.mail_crt_provider](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autorité de certification signant les certificats des domaines extérieurs.
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
-
-## Variables for expert
-
-### Général
-
-#### Annuaire OpenLDAP
+#### OpenLDAP directory
##### Client
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_family](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP.
**Default:** all |
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
+| **[general.ldap.client.ldapclient_family](dictionaries/31_dovecot.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families.
**Default:** all |
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **LDAP**
-- **ReverseProxy**
-- **LMTP**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [LDAP](../README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -82,10 +76,9 @@ dovecot:
zones_name:
- ldap
- localdns
+ - oauth2
- reverseproxy
- smtp
- - lmtp
- - oauth2
values:
general.mail.domain.mail_domains:
- example.net
@@ -97,25 +90,23 @@ dovecot:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [relay-lmtp-client](../relay-lmtp-client/README.md)
- - [relay-mail-client](../relay-mail-client/README.md)
-- [ldap-client](../ldap-client/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [relay-lmtp-client](../relay-lmtp-client/README.md): Application service needs interact with a Postfix server with LMTP protocol.
+ - [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [ldap-client](../ldap-client/README.md): Application service needs interact with a LDAP server.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
-## Supplier
+## Useful for service
-[imap-client](../imap-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+[roundcube](../roundcube/README.md): Roundcube, a webmail.
diff --git a/seed/dovecot/applicationservice.yml b/seed/dovecot/applicationservice.yml
index 3875576a..9c6d8123 100644
--- a/seed/dovecot/applicationservice.yml
+++ b/seed/dovecot/applicationservice.yml
@@ -1,5 +1,6 @@
format: '0.1'
-description: Postfix and Dovecot as mail servers (Submission and IMAP)
+description: Postfix and Dovecot as mail servers (IMAP and submission)
+help: "This application service provides email server. Two servers are used: Dovecot as IMAP server and Postfix as submission server. In addition, an auto-detection file of the email configuration is set up."
website: https://www.dovecot.org/
depends:
- base-fedora-36
diff --git a/seed/dovecot/dictionaries/31_dovecot.xml b/seed/dovecot/dictionaries/31_dovecot.xml
index 6aab8278..06d5381f 100644
--- a/seed/dovecot/dictionaries/31_dovecot.xml
+++ b/seed/dovecot/dictionaries/31_dovecot.xml
@@ -63,21 +63,21 @@
-
+
-
+
-
-
+
+
-
+
self-signed
self-signed
letsencrypt
-
+
diff --git a/seed/dovecot/templates/config-v1.1.xml b/seed/dovecot/templates/config-v1.1.xml
index f45092d7..55e986b8 100644
--- a/seed/dovecot/templates/config-v1.1.xml
+++ b/seed/dovecot/templates/config-v1.1.xml
@@ -1,5 +1,5 @@
-# GNUNUX: from https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat -->
+
{%set domain = rougail_variable %}
{%set leader = general.mail.domain.mail_domains[mail_domains.index(domain)] %}
{%set imap_domain = leader.imap_domainname %}
diff --git a/seed/forgejo/README.md b/seed/forgejo/README.md
index 1454e67d..2c6f0884 100644
--- a/seed/forgejo/README.md
+++ b/seed/forgejo/README.md
@@ -3,28 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# forgejo
## Synopsis
-Forgejo, a community managed lightweight code hosting solution.
-[Software's website.](https://forgejo.org/)
+[Forgejo, a community managed lightweight code hosting solution.](https://forgejo.org/)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### Forgejo
@@ -35,39 +36,23 @@ Git forge Forgejo.
| **[general.forgejo.forgejo_title](dictionaries/31_forgejo.xml)**
mandatory
**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.
**Default:** Forgejo : Au-delà du développement. Nous forgeons. |
| **[general.forgejo.forgejo_mail_sender](dictionaries/31_forgejo.xml)**
mandatory
**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.
**Example:** admin@example.net |
+## Variables
-## Variables for expert
-
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Forge
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Forge logiciel Forgejo
**Example:** Example description |
@@ -80,24 +65,28 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/31_forgejo.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** users |
-| Parameter | Comments |
+| Parameter | Comment |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Développement |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_note.png |
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **ReverseProxy**
-- **Postgresql**
-- **Redis**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [Redis](../README.Redis.md): Automaticly create account and connexion to a Redis server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -108,11 +97,11 @@ forgejo:
applicationservice: forgejo
zones_name:
- localdns
- - reverseproxy
- - smtp
- - redis
- oauth2
- postgresql
+ - redis
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -121,24 +110,22 @@ forgejo:
## Dependances
-- [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [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)
- - [redis-common](../redis-common/README.md)
-- [oauth2-client](../oauth2-client/README.md)
+- [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [redis-client](../redis-client/README.md): Application service needs interact with a Redis server.
+ - [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
## Used by
[gitea](../gitea/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/gitea/README.md b/seed/gitea/README.md
index a6e085ae..b451a409 100644
--- a/seed/gitea/README.md
+++ b/seed/gitea/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# gitea
## Synopsis
@@ -11,24 +13,24 @@ Transitional package for Gitea to Forgejo.
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### Forgejo
Git forge Forgejo.
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|
| **[general.forgejo.forgejo_title](dictionaries/31_forgejo.xml)**
mandatory
**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.
**Default:** Forgejo : Au-delà du développement. Nous forgeons. |
@@ -36,54 +38,21 @@ Git forge Forgejo.
## Variables
-### Général
-
-#### Forgejo
-
-Git forge Forgejo.
-
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
-| **[general.forgejo.forgejo_mail_sender](dictionaries/31_forgejo.xml)**
mandatory
**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.
**Default:** *calculated*
**Example:** admin@example.net |
-
-#### Transitional family
-
-| Parameter | Comments |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------|
-| **[general.gitea.gitea_mail_sender](dictionaries/32_gitea.xml)**
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Transitional variable, please do not use it. |
-
-## Variables for expert
-
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Forge
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Forge logiciel Forgejo
**Example:** Example description |
@@ -96,24 +65,40 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/31_forgejo.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** users |
-| Parameter | Comments |
+| Parameter | Comment |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Développement |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_forgejo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_note.png |
+#### Forgejo
+
+Git forge Forgejo.
+
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|
+| **[general.forgejo.forgejo_mail_sender](dictionaries/31_forgejo.xml)**
mandatory
**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.
**Default:** *calculated*
**Example:** admin@example.net |
+
+#### Transitional family
+
+| Parameter | Comments |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------|
+| **[general.gitea.gitea_mail_sender](dictionaries/32_gitea.xml)**
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Transitional variable, please do not use it. |
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **ReverseProxy**
-- **Postgresql**
-- **Redis**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [Redis](../README.Redis.md): Automaticly create account and connexion to a Redis server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -124,11 +109,11 @@ gitea:
applicationservice: gitea
zones_name:
- localdns
- - reverseproxy
- - smtp
- - redis
- oauth2
- postgresql
+ - redis
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -136,21 +121,19 @@ gitea:
## Dependances
-- [forgejo](../forgejo/README.md)
- - [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
- - [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)
- - [redis-common](../redis-common/README.md)
- - [oauth2-client](../oauth2-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+ - [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+ - [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+ - [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+ - [redis-client](../redis-client/README.md): Application service needs interact with a Redis server.
+ - [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
+ - [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
diff --git a/seed/grafana/README.md b/seed/grafana/README.md
index 46cbcb0a..30c073f8 100644
--- a/seed/grafana/README.md
+++ b/seed/grafana/README.md
@@ -3,28 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# grafana
## Synopsis
-Grafana is an analytics and interactive visualization web application.
-[Software's website.](https://grafana.com/)
+[Grafana is an analytics and interactive visualization web application.](https://grafana.com/)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### OAuth2 client
@@ -34,32 +35,23 @@ This family is a leadership.
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_email_domain](dictionaries/31_grafana.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Domain name allowed to log on Grafana.
**Example:** example.net |
+## Variables
-## Variables for expert
-
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/31_grafana.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Grafana
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/31_grafana.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Visualisation de données
**Example:** Example description |
@@ -77,16 +69,20 @@ This family is a leadership.
| **[general.oauth2_client.oauth2_client_category](dictionaries/31_grafana.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Administration |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_grafana.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_note.png |
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **ReverseProxy**
-- **Postgresql**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -97,10 +93,10 @@ grafana:
applicationservice: grafana
zones_name:
- localdns
- - reverseproxy
- - smtp
- oauth2
- postgresql
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -109,18 +105,16 @@ grafana:
## Dependances
-- [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
diff --git a/seed/host-systemd-machined/README.md b/seed/host-systemd-machined/README.md
index 8799fc55..0dc4b4ce 100644
--- a/seed/host-systemd-machined/README.md
+++ b/seed/host-systemd-machined/README.md
@@ -3,21 +3,22 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# host-systemd-machined
## Synopsis
-Host with machine started in Systemd Machined environment.
-[Software's website.](https://www.freedesktop.org/wiki/Software/systemd/machined/)
+[Host with machine started in Systemd Machined environment.](https://www.freedesktop.org/wiki/Software/systemd/machined/)
## Basic variables
-### Général
+### General
#### network
-| Parameter | Comments |
+| Parameter | Comment |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------|
| **[general.network.output_interface](dictionaries/21_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de l'interface de sortie. |
@@ -34,34 +35,29 @@ This family is a leadership.
## Variables
-### Général
+### General
-| Parameter | Comments |
+| Parameter | Comment |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
| **[general.vm_swappiness](dictionaries/21_machined.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Ajustement de la mémoire virtuelle.
**Default:** 60 |
+#### base
+
+| Parameter | Comment |
+|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------|
+| **[general.base.time_zone](dictionaries/21_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Time zone.
**Default:** Europe/Paris |
+
#### network
##### interfaces
This family is a leadership.
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|
-| **[general.network.interfaces.interface_type](dictionaries/21_machined.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type de la carte.
**Choices:**
- `dhcp`
- `ipv4` |
+| Parameter | Comments |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------|
+| **[general.network.interfaces.interface_type](dictionaries/21_machined.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type de la carte.
**Choices:**
- `dhcp` ← default
- `ipv4` |
## Dependances
-- [base](../base/README.md)
-
-## Supplier
-
-[provider-systemd-machined](../provider-systemd-machined/README.md)
-
-## Providers
-
-- [prometheus](../prometheus/README.md)
-- [vector](../vector/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base](../base/README.md): Base of all application services.
diff --git a/seed/host-systemd-machined/dictionaries/21_machined.xml b/seed/host-systemd-machined/dictionaries/21_machined.xml
index b6fbbe85..39e9befb 100644
--- a/seed/host-systemd-machined/dictionaries/21_machined.xml
+++ b/seed/host-systemd-machined/dictionaries/21_machined.xml
@@ -33,10 +33,10 @@
-
+
-
+
@@ -73,6 +73,11 @@
resolvconf
+
+
+ Europe/Paris
+
+
diff --git a/seed/host-systemd-machined/extras/machined/00_machined.xml b/seed/host-systemd-machined/extras/machined/00_machined.xml
index 5fdb8102..708ac6e2 100644
--- a/seed/host-systemd-machined/extras/machined/00_machined.xml
+++ b/seed/host-systemd-machined/extras/machined/00_machined.xml
@@ -9,7 +9,7 @@
-
+
diff --git a/seed/imap-client/README.md b/seed/imap-client/README.md
index 469d5cbc..2039558f 100644
--- a/seed/imap-client/README.md
+++ b/seed/imap-client/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# imap-client
## Synopsis
@@ -12,9 +14,3 @@ Application service needs interact with an IMAP server.
## Used by
[roundcube](../roundcube/README.md)
-
-## Provider
-
-[dovecot](../dovecot/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/imap-client/dictionaries/21_imap_client.xml b/seed/imap-client/dictionaries/21_imap_client.xml
index 8295794d..8b11b2d7 100644
--- a/seed/imap-client/dictionaries/21_imap_client.xml
+++ b/seed/imap-client/dictionaries/21_imap_client.xml
@@ -7,7 +7,7 @@
-
+
root
diff --git a/seed/journald/README.md b/seed/journald/README.md
index 00a1d5e1..3d5e8627 100644
--- a/seed/journald/README.md
+++ b/seed/journald/README.md
@@ -3,20 +3,15 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# journald
## Synopsis
-Journald.
-[Software's website.](https://systemd.io/)
+[Journald.](https://systemd.io/)
## Used by
[systemd](../systemd/README.md)
-
-## Provider
-
-[journald_remote](../journald_remote/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/journald/dictionaries/20_journald.xml b/seed/journald/dictionaries/20_journald.xml
index 5edfcb1f..c035cf15 100644
--- a/seed/journald/dictionaries/20_journald.xml
+++ b/seed/journald/dictionaries/20_journald.xml
@@ -9,8 +9,7 @@
-
-
+
@@ -18,9 +17,5 @@
journald
-
- domain_name_eth0
- journal_host_name
-
diff --git a/seed/journald_remote/README.md b/seed/journald_remote/README.md
index b9bab683..d68657e0 100644
--- a/seed/journald_remote/README.md
+++ b/seed/journald_remote/README.md
@@ -3,20 +3,15 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# journald_remote
## Synopsis
-Journald remote.
-[Software's website.](https://systemd.io/)
+[Journald remote.](https://systemd.io/)
## Used by
[vector](../vector/README.md)
-
-## Supplier
-
-[journald](../journald/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/journald_remote/extras/accounts/00_accounts.xml b/seed/journald_remote/extras/accounts/00_accounts.xml
index a43a205f..38982d74 100644
--- a/seed/journald_remote/extras/accounts/00_accounts.xml
+++ b/seed/journald_remote/extras/accounts/00_accounts.xml
@@ -1,12 +1,11 @@
-
-
-
-
-
-
+
+
+
+
+
diff --git a/seed/ldap-client/README.md b/seed/ldap-client/README.md
index 23a8a20a..7cf712a2 100644
--- a/seed/ldap-client/README.md
+++ b/seed/ldap-client/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# ldap-client
## Synopsis
@@ -10,22 +12,18 @@ include_toc: true
Application service needs interact with a LDAP server.
+## Variables
-## Variables for expert
+### General
-### Général
-
-#### Annuaire OpenLDAP
+#### OpenLDAP directory
##### Client
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP. |
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
+| Parameter | Comments |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|
+| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families. |
+
## Used by
@@ -35,9 +33,3 @@ Application service needs interact with a LDAP server.
- [roundcube](../roundcube/README.md)
- [nextcloud](../nextcloud/README.md)
- [lemonldap](../lemonldap/README.md)
-
-## Provider
-
-[openldap](../openldap/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/ldap-client/dictionaries/21_ldap-client.xml b/seed/ldap-client/dictionaries/21_ldap-client.xml
index a4d4dda1..79a2c294 100644
--- a/seed/ldap-client/dictionaries/21_ldap-client.xml
+++ b/seed/ldap-client/dictionaries/21_ldap-client.xml
@@ -7,28 +7,28 @@
-
-
-
+
+
+
-
+
636
-
-
+
+
-
-
-
-
-
-
+
+
+
+
+
+
root
-
+
diff --git a/seed/lemonldap/README.md b/seed/lemonldap/README.md
index 343873ee..960a12e8 100644
--- a/seed/lemonldap/README.md
+++ b/seed/lemonldap/README.md
@@ -3,28 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# lemonldap
## Synopsis
-LemonLDAP, a Web Single Sign On and Access Management.
-[Software's website.](https://lemonldap-ng.org/)
+[LemonLDAP, a Web Single Sign On and Access Management.](https://lemonldap-ng.org/)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### LemonLDAP
@@ -34,41 +35,40 @@ Configuration de la solution d'authentification unique LemonLDAP::NG.
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|
| **[general.lemonldap.lemon_mail_admin](dictionaries/70_lemonldap_ng.xml)**
mandatory
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Courriel de l'administrateur.
**Example:** admin@example.net |
+## Variables
-## Variables for expert
+### General
-### Général
-
-#### Annuaire OpenLDAP
+#### OpenLDAP directory
##### Client
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_family](dictionaries/70_lemonldap_ng.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP.
**Default:** all |
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
-
-#### NGINX
-
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
+| **[general.ldap.client.ldapclient_family](dictionaries/70_lemonldap_ng.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families.
**Default:** all |
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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. |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
+
+
+
+## Variables for expert
+
+### General
+
+#### NGINX
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
#### LemonLDAP
@@ -80,13 +80,16 @@ Configuration de la solution d'authentification unique LemonLDAP::NG.
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **LDAP**
-- **ReverseProxy**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [LDAP](../README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -109,23 +112,30 @@ lemonldap:
## Dependances
-- [ldap-client](../ldap-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [base-debian-bullseye](../base-debian-bullseye/README.md)
- - [base-debian](../base-debian/README.md)
- - [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [ldap-client](../ldap-client/README.md): Application service needs interact with a LDAP server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [base-debian-bullseye](../base-debian-bullseye/README.md): Base information of a Debian Bulleye server.
+ - [base-debian](../base-debian/README.md): Base information of a Debian server.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for services
-[oauth2-client](../oauth2-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [dovecot](../dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
diff --git a/seed/lemonldap/extras/oauth2/00_oauth2.xml b/seed/lemonldap/extras/oauth2/00_oauth2.xml
index 9a1a382b..b9b9285a 100644
--- a/seed/lemonldap/extras/oauth2/00_oauth2.xml
+++ b/seed/lemonldap/extras/oauth2/00_oauth2.xml
@@ -1,24 +1,24 @@
-
+
-
-
+
+
-
-
+
+
-
-
+
+
HS512
RS256
-
+
diff --git a/seed/loki/README.md b/seed/loki/README.md
index 41689faf..34313356 100644
--- a/seed/loki/README.md
+++ b/seed/loki/README.md
@@ -3,20 +3,24 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# loki
## Synopsis
-Loki, a log aggregation platform.
-[Software's website.](https://grafana.com/)
+[Loki, a log aggregation platform.](https://grafana.com/)
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -32,18 +36,16 @@ loki:
## Dependances
-- [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for service
-[vector](../vector/README.md)
-
-[All applications services for this dataset.](../README.md)
+[vector](../vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
diff --git a/seed/loki/dictionaries/20_loki.xml b/seed/loki/dictionaries/20_loki.xml
index 5b5fb9e3..b3b6e1d6 100644
--- a/seed/loki/dictionaries/20_loki.xml
+++ b/seed/loki/dictionaries/20_loki.xml
@@ -9,7 +9,7 @@
-
+
diff --git a/seed/mailman/README.md b/seed/mailman/README.md
index beb4b9f6..2aa738d8 100644
--- a/seed/mailman/README.md
+++ b/seed/mailman/README.md
@@ -3,32 +3,33 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# mailman
## Synopsis
-GNU Mailman, managing electronic mail discussion and e-newsletter lists.
-[Software's website.](https://www.list.org)
+[GNU Mailman, managing electronic mail discussion and e-newsletter lists.](https://www.list.org)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### Gestionnaire de liste
-| Parameter | Comments |
+| Parameter | Comment |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|
| **[general.mailman.mailman_mail_owner](dictionaries/31_mailman.xml)**
mandatory
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Courriel du gestionnaire de liste du site.
**Example:** admin@example.net |
| **[general.mailman.mailman_domains](dictionaries/31_mailman.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine des listes.
**Example:** list.example.net |
@@ -39,45 +40,27 @@ This family is a leadership.
This a dynamic family generated from the variable "general.mailman.mailman_domains".
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|
-| **[mailman.list_*suffix value*.name_*suffix value*](extras/mailman/20_mailman.xml)**
mandatory, multiple
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom des listes . |
+| Parameter | Comments |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------|
+| **[mailman.list_*suffix value*.name_*suffix value*](extras/mailman/20_mailman.xml)**
mandatory, multiple
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom des listes *suffix value*. |
+## Variables
-## Variables for expert
-
-### Général
-
-#### NGINX
-
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/31_mailman.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Liste de distribution
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/31_mailman.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Liste de distribution Mailman
**Example:** Example description |
@@ -90,24 +73,39 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/31_mailman.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** users |
-| Parameter | Comments |
+| Parameter | Comment |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/31_mailman.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Développement |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_mailman.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_email.png |
+## Variables for expert
+
+### General
+
+#### NGINX
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
+
+
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **ReverseProxy**
-- **Postgresql**
-- **LMTP**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -118,11 +116,10 @@ mailman:
applicationservice: mailman
zones_name:
- localdns
- - reverseproxy
- - smtp
- - lmtp
- oauth2
- postgresql
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -133,22 +130,20 @@ mailman:
## Dependances
-- [base-debian-bullseye](../base-debian-bullseye/README.md)
- - [base-debian](../base-debian/README.md)
- - [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [relay-lmtp-client](../relay-lmtp-client/README.md)
- - [relay-mail-client](../relay-mail-client/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-debian-bullseye](../base-debian-bullseye/README.md): Base information of a Debian Bulleye server.
+ - [base-debian](../base-debian/README.md): Base information of a Debian server.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [relay-lmtp-client](../relay-lmtp-client/README.md): Application service needs interact with a Postfix server with LMTP protocol.
+ - [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
diff --git a/seed/mariadb-client/README.md b/seed/mariadb-client/README.md
index dca610f0..0eb02b26 100644
--- a/seed/mariadb-client/README.md
+++ b/seed/mariadb-client/README.md
@@ -3,20 +3,15 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# mariadb-client
## Synopsis
-Application service needs interact with a MariaDB server.
-[Software's website.](https://mariadb.org/)
+[Application service needs interact with a MariaDB server.](https://mariadb.org/)
## Used by
[piwigo](../piwigo/README.md)
-
-## Provider
-
-[mariadb](../mariadb/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/mariadb-client/dictionaries/20_mariadb.xml b/seed/mariadb-client/dictionaries/20_mariadb.xml
index 6d3f7215..83144041 100644
--- a/seed/mariadb-client/dictionaries/20_mariadb.xml
+++ b/seed/mariadb-client/dictionaries/20_mariadb.xml
@@ -5,9 +5,9 @@
-
+
-
+
diff --git a/seed/mariadb/README.md b/seed/mariadb/README.md
index dbf9232a..3c55e830 100644
--- a/seed/mariadb/README.md
+++ b/seed/mariadb/README.md
@@ -3,20 +3,24 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# mariadb
## Synopsis
-MariaDB, a relational database.
-[Software's website.](https://mariadb.org/)
+[MariaDB, a relational database.](https://mariadb.org/)
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -32,18 +36,16 @@ mariadb:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for service
-[mariadb-client](../mariadb-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+[piwigo](../piwigo/README.md): Piwigo, a photo management software.
diff --git a/seed/mariadb/extras/accounts/00_accounts.xml b/seed/mariadb/extras/accounts/00_accounts.xml
index e5a3eeb6..bc109f7b 100644
--- a/seed/mariadb/extras/accounts/00_accounts.xml
+++ b/seed/mariadb/extras/accounts/00_accounts.xml
@@ -1,11 +1,11 @@
-
-
-
-
-
+
+
+
+
+
diff --git a/seed/nextcloud/README.md b/seed/nextcloud/README.md
index d72cd4e6..fcff121b 100644
--- a/seed/nextcloud/README.md
+++ b/seed/nextcloud/README.md
@@ -3,107 +3,61 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nextcloud
## Synopsis
-Nextcloud, Online collaboration platform.
-[Software's website.](https://nextcloud.com/)
+[Nextcloud, Online collaboration platform.](https://nextcloud.com/)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### Nextcloud
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------|
-| **[general.nextcloud.nextcloud_mail_admin](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Example:** admin@example.net |
+| Parameter | Comments |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------|
+| **[general.nextcloud.nextcloud_mail_admin](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The administrator email.
**Example:** admin@example.net |
+## Variables
-## Variables for expert
+### General
-### Général
-
-#### PHP
-
-Paramètrage avancé de PHP.
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST.
Valeur en Mo.
**Default:** 32 |
-| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale d'un fichier à charger.
Valeur en Mo.
**Default:** 16 |
-| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Temps maximal d'exécution d'un script.
Valeur en secondes.
**Default:** 30 |
-| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée maximale pour analyser les données d'entrée.
Valeur en secondes.
**Default:** 60 |
-| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille mémoire maximale qu'un script est autorisé à allouer.
Valeur en Mo.
**Default:** 512 |
-| **[general.php.php_display_errors](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Affichage des erreurs à l'écran.
**Default:** False |
-| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée de vie des données sur le serveur.
Valeur en secondes.
**Default:** 3600 |
-| **[general.php.php_browscap](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer la directive de configuration browscap.
La directive de configuration browscap permet d'obtenir plus d'information sur les capacités du navigateur client grâce à la fonction get_browser().
**Default:** False |
-| **[general.php.time_zone](dictionaries/20_php.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Fuseau horaire.
**Default:** Europe/Paris |
-| **[general.php.php_enable_output_buffering](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer les tampons de sortie.
**Default:** False |
-| **[general.php.php_disable_pcntl](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Désactiver PCNTL.
**Default:** False |
-
-#### Apache
-
-Paramètrage avancé du serveur web Apache.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
-| **[general.apache.apache_timeout](dictionaries/20_web.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Temps d'attente des entrées/sorties avant de considérer qu'une requête a échoué.
Temps en secondes.
**Default:** 300 |
-| **[general.apache.apache_keepalive](dictionaries/20_web.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autoriser les connexions persistantes.
**Default:** True |
-
-#### Annuaire OpenLDAP
+#### OpenLDAP directory
##### Client
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP. |
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
+| Parameter | Comment |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|
+| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families. |
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Collaboration
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Plateforme de collaboration Nextcloud
**Example:** Example description |
@@ -116,25 +70,56 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/30_oauth2_client.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** users |
-| Parameter | Comments |
+| Parameter | Comment |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Diffusion |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_nextcloud.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_folder.png |
+## Variables for expert
+
+### General
+
+#### PHP
+
+Paramètrage avancé de PHP.
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
+| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum size of POST data that PHP will accept.
Value in Mb.
**Default:** 32 |
+| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum allowed size for uploaded files.
Value in Mb.
**Default:** 16 |
+| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 30 |
+| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 60 |
+| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of memory a script may consume.
Value in Mb.
**Default:** 512 |
+| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Data will be seen as 'garbage' and potentially cleaned up after this delay.
Value in seconds.
**Default:** 3600 |
+
+#### Apache
+
+Advance Apache web server settings.
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
+| **[general.apache.apache_timeout](dictionaries/20_web.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Amount of time the server will wait for certain events before failing a request.
Time in seconds.
**Default:** 300 |
+| **[general.apache.apache_keepalive](dictionaries/20_web.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Enables HTTP persistent connections.
**Default:** True |
+
+
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **LDAP**
-- **ReverseProxy**
-- **Postgresql**
-- **Redis**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [LDAP](../README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [Redis](../README.Redis.md): Automaticly create account and connexion to a Redis server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -146,11 +131,11 @@ nextcloud:
zones_name:
- ldap
- localdns
- - reverseproxy
- - smtp
- - redis
- oauth2
- postgresql
+ - redis
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -159,24 +144,22 @@ nextcloud:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [ldap-client](../ldap-client/README.md)
-- [redis-client](../redis-client/README.md)
- - [redis-common](../redis-common/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-- [apache](../apache/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [php-fpm](../php-fpm/README.md)
- - [php](../php/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [ldap-client](../ldap-client/README.md): Application service needs interact with a LDAP server.
+- [redis-client](../redis-client/README.md): Application service needs interact with a Redis server.
+ - [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [apache](../apache/README.md): Apache as web server.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [php-fpm](../php-fpm/README.md): PHP FPM.
+ - [php](../php/README.md): PHP, a popular general-purpose scripting language.
diff --git a/seed/nextcloud/applicationservice.yml b/seed/nextcloud/applicationservice.yml
index 993a124b..1a82fdcf 100644
--- a/seed/nextcloud/applicationservice.yml
+++ b/seed/nextcloud/applicationservice.yml
@@ -1,5 +1,5 @@
format: '0.1'
-description: Nextcloud, Online collaboration platform
+description: Nextcloud, Online collaboration platform
website: https://nextcloud.com/
depends:
- base-fedora-36
diff --git a/seed/nextcloud/dictionaries/31_nextcloud.xml b/seed/nextcloud/dictionaries/31_nextcloud.xml
index 0ef9bd8e..fb5ed8a4 100644
--- a/seed/nextcloud/dictionaries/31_nextcloud.xml
+++ b/seed/nextcloud/dictionaries/31_nextcloud.xml
@@ -15,7 +15,7 @@
-
+
diff --git a/seed/nginx-common/README.md b/seed/nginx-common/README.md
index 15c4ba28..e270e78f 100644
--- a/seed/nginx-common/README.md
+++ b/seed/nginx-common/README.md
@@ -3,32 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nginx-common
## Synopsis
-Nginx common configuration.
-[Software's website.](https://nginx.org/)
+[Nginx common configuration.](https://nginx.org/)
## Variables for expert
-### Général
+### General
#### NGINX
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
## Used by
- [nginx-reverse-proxy](../nginx-reverse-proxy/README.md)
- [nginx-https](../nginx-https/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/nginx-common/dictionaries/21_nginx.xml b/seed/nginx-common/dictionaries/21_nginx.xml
index 042c4fb1..15fdfd50 100644
--- a/seed/nginx-common/dictionaries/21_nginx.xml
+++ b/seed/nginx-common/dictionaries/21_nginx.xml
@@ -12,24 +12,24 @@
-
-
+
+
False
-
+
False
-
+
/usr/share/nginx/html
-
+
128
128
64
32
-
+
32
diff --git a/seed/nginx-https/README.md b/seed/nginx-https/README.md
index 996375c5..c047fcf7 100644
--- a/seed/nginx-https/README.md
+++ b/seed/nginx-https/README.md
@@ -3,18 +3,19 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nginx-https
## Synopsis
-Nginx as HTTPS web site.
-[Software's website.](https://nginx.org/)
+[Nginx as HTTPS web site.](https://nginx.org/)
## Dependances
-- [nginx-common](../nginx-common/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
+- [nginx-common](../nginx-common/README.md): Nginx common configuration.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
## Used by
@@ -26,5 +27,3 @@ Nginx as HTTPS web site.
- [dovecot](../dovecot/README.md)
- [roundcube](../roundcube/README.md)
- [lemonldap](../lemonldap/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/nginx-reverse-proxy/README.md b/seed/nginx-reverse-proxy/README.md
index a220c079..5f9266bf 100644
--- a/seed/nginx-reverse-proxy/README.md
+++ b/seed/nginx-reverse-proxy/README.md
@@ -3,47 +3,50 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nginx-reverse-proxy
## Synopsis
-Nginx as reverse proxy.
-[Software's website.](https://nginx.org/)
+[Nginx as reverse proxy.](https://nginx.org/)
+The reverse proxy provides access to internal services.
+These internal services are integrated automatically.
-## Variables
+## Basic variables
-### Général
+### General
#### NGINX
-Paramétrage global de NGINX.
+| Parameter | Comments |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_default](dictionaries/25_nginx.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Default reverse proxy domaine name.
If a client access to reverse proxy with an unknown domain name, the connexion is redirect to this domain name. By default this variable is the first associated service to this reverse proxy.
**Default:** *calculated* |
+| **[general.nginx.nginx_certificates_provider](dictionaries/25_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type of certificate autority signing external certificates.
The certificate can be self-signed (therefore invalid by default for the client) or obtained via the Let's Encrypt service (generally valid for the client).
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_default](dictionaries/25_nginx.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine du serveur mandataire inverse par défaut.
Si un client accède au serveur avec un nom de domaine non déclaré, le flux est redirigé vers ce domaine.
**Default:** *calculated* |
-| **[general.nginx.nginx_certificates_provider](dictionaries/25_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autorité de certification signant le certificat des domaines extérieurs.
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
## Variables for expert
-### Général
+### General
#### NGINX
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -59,19 +62,30 @@ nginx-reverse-proxy:
## Dependances
-- [nginx-common](../nginx-common/README.md)
-- [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [nginx-common](../nginx-common/README.md): Nginx common configuration.
+- [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for services
-[reverse-proxy-client](../reverse-proxy-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [dovecot](../dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [lemonldap](../lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [nginx-static](../nginx-static/README.md): Nginx as static web site.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
+- [speedtest-rs](../speedtest-rs/README.md): Speedtest-rs, a very lightweight Speedtest.
+- [vaultwarden](../vaultwarden/README.md): Vaultwarden, a password manager.
diff --git a/seed/nginx-reverse-proxy/applicationservice.yml b/seed/nginx-reverse-proxy/applicationservice.yml
index 84fd3200..b55a580c 100644
--- a/seed/nginx-reverse-proxy/applicationservice.yml
+++ b/seed/nginx-reverse-proxy/applicationservice.yml
@@ -1,5 +1,8 @@
format: '0.1'
description: Nginx as reverse proxy
+help: |
+ The reverse proxy provides access to internal services.
+ These internal services are integrated automatically.
website: https://nginx.org/
depends:
- nginx-common
diff --git a/seed/nginx-reverse-proxy/dictionaries/25_nginx.xml b/seed/nginx-reverse-proxy/dictionaries/25_nginx.xml
index f63e3377..9c72f362 100644
--- a/seed/nginx-reverse-proxy/dictionaries/25_nginx.xml
+++ b/seed/nginx-reverse-proxy/dictionaries/25_nginx.xml
@@ -19,19 +19,19 @@
443
-
-
- self-signed
- self-signed
- letsencrypt
-
-
+
+
False
False
+
+ self-signed
+ self-signed
+ letsencrypt
+
diff --git a/seed/nginx-reverse-proxy/extras/nginx/00_nginx.xml b/seed/nginx-reverse-proxy/extras/nginx/00_nginx.xml
index b9a51d3b..a490543d 100644
--- a/seed/nginx-reverse-proxy/extras/nginx/00_nginx.xml
+++ b/seed/nginx-reverse-proxy/extras/nginx/00_nginx.xml
@@ -1,15 +1,15 @@
-
+
-
-
-
-
-
-
+
+
+
+
+
+
diff --git a/seed/nginx-static/README.md b/seed/nginx-static/README.md
index 878c578c..4a7bf241 100644
--- a/seed/nginx-static/README.md
+++ b/seed/nginx-static/README.md
@@ -3,73 +3,73 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nginx-static
## Synopsis
-Nginx as static web site.
-[Software's website.](https://nginx.org/)
+[Nginx as static web site.](https://nginx.org/)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comments |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
## Variables
-### Général
+### General
#### NGINX
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
+| Parameter | Comment |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
| **[general.nginx.nginx_root](dictionaries/22_nginx_static.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Adresse racine du site web.
**Default:** /srv/static |
-
-
-## Variables for expert
-
-### Général
-
-#### NGINX
-
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
-
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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. |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
+
+## Variables for expert
+
+### General
+
+#### NGINX
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
+
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **ReverseProxy**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -88,17 +88,15 @@ nginx-static:
## Dependances
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
diff --git a/seed/nsd-local/README.md b/seed/nsd-local/README.md
index 54ea59cb..5a5a52e2 100644
--- a/seed/nsd-local/README.md
+++ b/seed/nsd-local/README.md
@@ -3,21 +3,25 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nsd-local
## Synopsis
-NSD, an authoritative DNS name server for local resolution.
-[Software's website.](https://www.nlnetlabs.nl/projects/nsd/about/)
+[NSD, an authoritative DNS name server for local resolution.](https://www.nlnetlabs.nl/projects/nsd/about/)
## Requirements services
-- **LocalDNS**
-- Journald
-- ExternalDNS
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [ExternalDNS](../README.ExternalDNS.md): DNS forwarder for all DNS zones.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -28,28 +32,45 @@ nsd-local:
applicationservice: nsd-local
provider_zone: localdns
zones_name:
+ - externaldns
- localdns
```
## Dependances
-- [nsd](../nsd/README.md)
- - [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [nsd](../nsd/README.md): NSD, an authoritative DNS name server.
+ - [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for services
-[dns-local](../dns-local/README.md)
-
-## Provider
-
-[unbound](../unbound/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [dovecot](../dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [lemonldap](../lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [loki](../loki/README.md): Loki, a log aggregation platform.
+- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [mariadb](../mariadb/README.md): MariaDB, a relational database.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [nginx-reverse-proxy](../nginx-reverse-proxy/README.md): Nginx as reverse proxy.
+- [nginx-static](../nginx-static/README.md): Nginx as static web site.
+- [nsd](../nsd/README.md): NSD, an authoritative DNS name server.
+- [nsd-local](../nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [openldap](../openldap/README.md): OpenLDAP, the LDAP server.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [postgresql](../postgresql/README.md): Postgresql, a database.
+- [prometheus](../prometheus/README.md): Prometheus, an event monitoring.
+- [redis](../redis/README.md): Redis, an in-memory data structure store.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
+- [speedtest-rs](../speedtest-rs/README.md): Speedtest-rs, a very lightweight Speedtest.
+- [vaultwarden](../vaultwarden/README.md): Vaultwarden, a password manager.
+- [vector](../vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
diff --git a/seed/nsd-local/dictionaries/21_nsd-local.xml b/seed/nsd-local/dictionaries/21_nsd-local.xml
index 4ee4230b..071af5e2 100644
--- a/seed/nsd-local/dictionaries/21_nsd-local.xml
+++ b/seed/nsd-local/dictionaries/21_nsd-local.xml
@@ -3,12 +3,12 @@
-
+
-
+
diff --git a/seed/nsd/README.md b/seed/nsd/README.md
index 526650aa..9fccfb3d 100644
--- a/seed/nsd/README.md
+++ b/seed/nsd/README.md
@@ -3,28 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# nsd
## Synopsis
-NSD, an authoritative DNS name server.
-[Software's website.](https://www.nlnetlabs.nl/projects/nsd/about/)
+[NSD, an authoritative DNS name server.](https://www.nlnetlabs.nl/projects/nsd/about/)
## Basic variables
-### Général
+### General
#### Serveur DNS
-| Parameter | Comments |
+| Parameter | Comment |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
| **[general.dns_server.nsd_allowed_client_cidr](dictionaries/20_nsd.xml)**
multiple
**Type:** [`network_cidr`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Clients autorisés à interroger le serveur DNS. |
| **[general.dns_server.nsd_resolver](dictionaries/20_nsd.xml)**
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine du résolveur DNS associé. |
#### Zone DNS
-| Parameter | Comments |
+| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|
| **[general.dns_zone.nsd_zones](dictionaries/20_nsd.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Zones DNS.
**Example:** subdomain.example.net |
@@ -32,7 +33,7 @@ NSD, an authoritative DNS name server.
This family is a leadership.
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------|
| **[general.dns_reverses.nsd_reverse_network](dictionaries/20_nsd.xml)**
multiple
**Type:** [`network_cidr`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Réseau pour la résolution reverse. |
@@ -46,25 +47,28 @@ This a dynamic family generated from the variable "general.dns_zone.nsd_zones".
This family is a leadership.
-| Parameter | Comments |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
-| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.hostname_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'hôte pour . |
-| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.type_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type pour .
**Choices:**
- `A`
- `CNAME` |
-| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.ip_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory
**Type:** [`ip`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Adresse IP a renvoyer pour . |
-| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.cname_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine a renvoyer pour . |
+| Parameter | Comments |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
+| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.hostname_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'hôte pour *suffix value*. |
+| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.type_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type pour *suffix value*.
**Choices:**
- `A` ← default
- `CNAME` |
+| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.ip_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory
**Type:** [`ip`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Adresse IP a renvoyer pour *suffix value*. |
+| **[nsd.nsd_zone_*suffix value*.hostname_*suffix value*.cname_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine a renvoyer pour *suffix value*. |
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------|
-| **[nsd.nsd_zone_*suffix value*.ns_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom des serveurs de nom de la zone . |
+| Parameter | Comments |
+|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------|
+| **[nsd.nsd_zone_*suffix value*.ns_*suffix value*](extras/nsd/00_nsd.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom des serveurs de nom de la zone *suffix value*. |
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -82,18 +86,16 @@ nsd:
## Dependances
-- [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
## Used by
[nsd-local](../nsd-local/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/oauth2-client/README.md b/seed/oauth2-client/README.md
index 22d8fa00..5999b348 100644
--- a/seed/oauth2-client/README.md
+++ b/seed/oauth2-client/README.md
@@ -3,25 +3,36 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# oauth2-client
## Synopsis
Application service needs interact with a Oauth2 server.
+## Basic variables
-
-## Variables for expert
-
-### Général
+### General
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Example:** Example description |
-| **[general.oauth2_client.oauth2_client_login](dictionaries/30_oauth2_client.xml)**
**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. |
+
+
+
+## Variables
+
+### General
+
+#### OAuth2 client
+
+| Parameter | Comment |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------|
+| **[general.oauth2_client.oauth2_client_login](dictionaries/30_oauth2_client.xml)**
**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. |
##### external
@@ -35,6 +46,7 @@ Application service needs interact with a Oauth2 server.
| **[general.oauth2_client.oauth2_client_category](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Défaut |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** demo.png |
+
## Used by
- [odoo](../odoo/README.md)
@@ -46,9 +58,3 @@ Application service needs interact with a Oauth2 server.
- [forgejo](../forgejo/README.md)
- [roundcube](../roundcube/README.md)
- [nextcloud](../nextcloud/README.md)
-
-## Provider
-
-[lemonldap](../lemonldap/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/oauth2-client/dictionaries/30_oauth2_client.xml b/seed/oauth2-client/dictionaries/30_oauth2_client.xml
index 49454316..e829a151 100644
--- a/seed/oauth2-client/dictionaries/30_oauth2_client.xml
+++ b/seed/oauth2-client/dictionaries/30_oauth2_client.xml
@@ -5,8 +5,8 @@
-
-
+
+
False
@@ -31,7 +31,7 @@
HS512
RS256
-
+
diff --git a/seed/odoo/README.md b/seed/odoo/README.md
index 4b52c6e4..ca749d61 100644
--- a/seed/odoo/README.md
+++ b/seed/odoo/README.md
@@ -3,28 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# odoo
## Synopsis
-Odoo, an ERP and CRM.
-[Software's website.](https://www.odoo.com/fr)
+[Odoo, an ERP and CRM.](https://www.odoo.com/fr)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### Odoo
@@ -45,53 +46,31 @@ This family is a leadership.
| **[general.odoo.odoo_company_footer](dictionaries/40_odoo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Pied de page des documents.
**Example:** foot |
| **[general.odoo.odoo_company_layout](dictionaries/40_odoo.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Agencement des documents.
**Choices:**
- `standard` ← default
- `bold`
- `boxed`
- `striped` |
+## Variables
-## Variables for expert
+### General
-### Général
-
-#### Annuaire OpenLDAP
+#### OpenLDAP directory
##### Client
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP. |
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
-
-#### NGINX
-
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
+| Parameter | Comment |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|
+| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families. |
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/40_odoo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** ERP
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/40_odoo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** ERP Odoo
**Example:** Example description |
@@ -104,11 +83,24 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/40_odoo.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/40_odoo.xml)**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** |
-| Parameter | Comments |
+| Parameter | Comment |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/40_odoo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Entreprise |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/40_odoo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_note.png |
+
+
+## Variables for expert
+
+### General
+
+#### NGINX
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
+
#### Odoo
| Parameter | Comments |
@@ -117,15 +109,18 @@ This family is a leadership.
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **LDAP**
-- **ReverseProxy**
-- **Postgresql**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [LDAP](../README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -137,10 +132,10 @@ odoo:
zones_name:
- ldap
- localdns
- - reverseproxy
- - smtp
- oauth2
- postgresql
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -159,22 +154,20 @@ odoo:
## Dependances
-- [base-debian-bullseye](../base-debian-bullseye/README.md)
- - [base-debian](../base-debian/README.md)
- - [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-- [ldap-client](../ldap-client/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-debian-bullseye](../base-debian-bullseye/README.md): Base information of a Debian Bulleye server.
+ - [base-debian](../base-debian/README.md): Base information of a Debian server.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [ldap-client](../ldap-client/README.md): Application service needs interact with a LDAP server.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
diff --git a/seed/openldap/README.md b/seed/openldap/README.md
index f190b051..4fc9a546 100644
--- a/seed/openldap/README.md
+++ b/seed/openldap/README.md
@@ -3,13 +3,14 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# openldap
## Synopsis
-OpenLDAP, the LDAP server.
-[Software's website.](https://www.openldap.org/)
+[OpenLDAP, the LDAP server.](https://www.openldap.org/)
This service provides a LDAP server.
@@ -22,7 +23,6 @@ initial password will be generated but never updated. You can modify them.
Other services may also require automatic user creation.
-
## Variables
### Accounts
@@ -39,7 +39,7 @@ Management of manually created local users. Those users are not classified. This
| **[accounts.users.ldap_user_gn](extras/accounts/00_account.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Given name.
**Example:** John |
| **[accounts.users.ldap_user_sn](extras/accounts/00_account.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Surname.
**Example:** Doe |
-| Parameter | Comments |
+| Parameter | Comment |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| **[accounts.families](extras/accounts/00_account.xml)**
multiple
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Families to create.
Users can be classified into families. This variable contains all the names of the families to be created. |
@@ -51,27 +51,27 @@ This a dynamic family generated from the variable "accounts.families".
Management of manually created users. Those users are classified in a family. This family is a leadership.
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|
-| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_mail_*suffix value*](extras/accounts/00_account.xml)**
multiple
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Email address for the family .
An user is identify by his email address.
**Example:** johndoe@family.net |
-| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_aliases_*suffix value*](extras/accounts/00_account.xml)**
multiple
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Emails aliases for the family .
**Example:** jdoe@family.net |
-| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_uid_*suffix value*](extras/accounts/00_account.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Account name for the family .
**Example:** jdoe |
-| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_gn_*suffix value*](extras/accounts/00_account.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Given name for the family .
**Example:** John |
-| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_sn_*suffix value*](extras/accounts/00_account.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Surname for the family .
**Example:** Doe |
+| Parameter | Comments |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|
+| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_mail_*suffix value*](extras/accounts/00_account.xml)**
multiple
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Email address for the family *suffix value*.
An user is identify by his email address.
**Example:** johndoe@family.net |
+| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_aliases_*suffix value*](extras/accounts/00_account.xml)**
multiple
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Emails aliases for the family *suffix value*.
**Example:** jdoe@family.net |
+| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_uid_*suffix value*](extras/accounts/00_account.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Account name for the family *suffix value*.
**Example:** jdoe |
+| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_gn_*suffix value*](extras/accounts/00_account.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Given name for the family *suffix value*.
**Example:** John |
+| **[accounts.family_*suffix value*.users_*suffix value*.ldap_user_sn_*suffix value*](extras/accounts/00_account.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Surname for the family *suffix value*.
**Example:** Doe |
## Variables for expert
-### Général
+### General
#### LDAP
-| Parameter | Comments |
+| Parameter | Comment |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **[general.ldap.ldap_schemas](dictionaries/21_openldap-server.xml)**
mandatory, multiple
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Additional LDAP schemas.
**Default:** - /etc/openldap/schema/cosine.ldif
- /etc/openldap/schema/inetorgperson.ldif
- /etc/openldap/schema/nis.ldif
- /etc/openldap/schema/misc.ldif
|
##### Limits
-| Parameter | Comments |
+| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
| **[general.ldap.limits.ldap_loglevel](dictionaries/21_openldap-server.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Log level.
**Default:** 0 |
| **[general.ldap.limits.ldap_sizelimit](dictionaries/21_openldap-server.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nombre maximum d'entrées à retourner lors d'une requête.
**Default:** 5000 |
@@ -79,7 +79,7 @@ Management of manually created users. Those users are classified in a family. Th
##### DB environment
-| Parameter | Comments |
+| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
| **[general.ldap.db_environment.db_cache_size_g](dictionaries/21_openldap-server.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Quantité de Giga-octets à utiliser pour le cache HDB.
**Default:** 0 |
| **[general.ldap.db_environment.db_cache_size_o](dictionaries/21_openldap-server.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Quantité d'octets à utiliser pour le cache HDB.
**Default:** 268435456 |
@@ -96,10 +96,13 @@ Management of manually created users. Those users are classified in a family. Th
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -115,18 +118,21 @@ openldap:
## Dependances
-- [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for services
-[ldap-client](../ldap-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [dovecot](../dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [lemonldap](../lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
diff --git a/seed/openldap/extras/accounts/00_account.xml b/seed/openldap/extras/accounts/00_account.xml
index c1972f87..72caac7c 100644
--- a/seed/openldap/extras/accounts/00_account.xml
+++ b/seed/openldap/extras/accounts/00_account.xml
@@ -1,12 +1,12 @@
-
+
-
-
-
-
+
+
+
+
diff --git a/seed/peertube/README.md b/seed/peertube/README.md
index b1605d4d..5f97f747 100644
--- a/seed/peertube/README.md
+++ b/seed/peertube/README.md
@@ -3,28 +3,29 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# peertube
## Synopsis
-Peertube, a federated (ActivityPub) video streaming platform.
-[Software's website.](https://www.openldap.org/)
+[Peertube, a federated (ActivityPub) video streaming platform.](https://www.openldap.org/)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/30_peertube.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### peertube
@@ -34,56 +35,21 @@ This family is a leadership.
## Variables
-### Général
-
-#### peertube
-
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.peertube.peertube_short_description](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Description courte de l'instance.
**Default:** PeerTube, an ActivityPub-federated video streaming platform using P2P directly in your web browser. |
-| **[general.peertube.peertube_description](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Description de l'instance.
**Default:** Welcome to this PeerTube instance! |
-
-## Variables for expert
-
-### Général
-
-#### NGINX
-
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/30_peertube.xml)**
mandatory
**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)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
+| Parameter | Comment |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
**Default:** 12G |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Vidéo
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Plateforme de partage de vidéo Peertube
**Example:** Example description |
@@ -96,24 +62,45 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/30_peertube.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** users |
-| Parameter | Comments |
+| Parameter | Comment |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Réseaux sociaux |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_video.png |
+#### peertube
+
+| Parameter | Comments |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **[general.peertube.peertube_short_description](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Description courte de l'instance.
**Default:** PeerTube, an ActivityPub-federated video streaming platform using P2P directly in your web browser. |
+| **[general.peertube.peertube_description](dictionaries/30_peertube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Description de l'instance.
**Default:** Welcome to this PeerTube instance! |
+
+## Variables for expert
+
+### General
+
+#### NGINX
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
+
## Requirements services
-- **ExternalDNS**
-- Journald
-- **SMTP**
-- **ReverseProxy**
-- **Postgresql**
-- **Redis**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [ExternalDNS](../README.ExternalDNS.md): DNS forwarder for all DNS zones.
+- [Redis](../README.Redis.md): Automaticly create account and connexion to a Redis server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -123,12 +110,12 @@ Zone names are provided as examples. Think about adapting with the value of prov
peertube:
applicationservice: peertube
zones_name:
- - localdns
- - reverseproxy
- - smtp
- - redis
+ - externaldns
- oauth2
- postgresql
+ - redis
+ - reverseproxy
+ - smtp
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -137,24 +124,22 @@ peertube:
## Dependances
-- [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [dns-external](../dns-external/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [redis-client](../redis-client/README.md)
- - [redis-common](../redis-common/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [dns-external](../dns-external/README.md): DNS client with resolution on all zones (especially outside).
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [redis-client](../redis-client/README.md): Application service needs interact with a Redis server.
+ - [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
diff --git a/seed/php-fpm/README.md b/seed/php-fpm/README.md
index 1670268f..dfb7d3e7 100644
--- a/seed/php-fpm/README.md
+++ b/seed/php-fpm/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# php-fpm
## Synopsis
@@ -11,12 +13,10 @@ PHP FPM.
## Dependances
-- [php](../php/README.md)
+- [php](../php/README.md): PHP, a popular general-purpose scripting language.
## Used by
- [piwigo](../piwigo/README.md)
- [roundcube](../roundcube/README.md)
- [nextcloud](../nextcloud/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/php/README.md b/seed/php/README.md
index 99e6d89b..953cd207 100644
--- a/seed/php/README.md
+++ b/seed/php/README.md
@@ -3,40 +3,34 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# php
## Synopsis
-PHP, a popular general-purpose scripting language.
-[Software's website.](https://secure.php.net/)
+[PHP, a popular general-purpose scripting language.](https://secure.php.net/)
## Variables for expert
-### Général
+### General
#### PHP
Paramètrage avancé de PHP.
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST.
Valeur en Mo.
**Default:** 32 |
-| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale d'un fichier à charger.
Valeur en Mo.
**Default:** 16 |
-| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Temps maximal d'exécution d'un script.
Valeur en secondes.
**Default:** 30 |
-| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée maximale pour analyser les données d'entrée.
Valeur en secondes.
**Default:** 60 |
-| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille mémoire maximale qu'un script est autorisé à allouer.
Valeur en Mo.
**Default:** 512 |
-| **[general.php.php_display_errors](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Affichage des erreurs à l'écran.
**Default:** False |
-| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée de vie des données sur le serveur.
Valeur en secondes.
**Default:** 3600 |
-| **[general.php.php_browscap](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer la directive de configuration browscap.
La directive de configuration browscap permet d'obtenir plus d'information sur les capacités du navigateur client grâce à la fonction get_browser().
**Default:** False |
-| **[general.php.time_zone](dictionaries/20_php.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Fuseau horaire.
**Default:** Europe/Paris |
-| **[general.php.php_enable_output_buffering](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer les tampons de sortie.
**Default:** True |
-| **[general.php.php_disable_pcntl](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Désactiver PCNTL.
**Default:** True |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
+| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum size of POST data that PHP will accept.
Value in Mb.
**Default:** 32 |
+| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum allowed size for uploaded files.
Value in Mb.
**Default:** 16 |
+| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 30 |
+| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 60 |
+| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of memory a script may consume.
Value in Mb.
**Default:** 512 |
+| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Data will be seen as 'garbage' and potentially cleaned up after this delay.
Value in seconds.
**Default:** 3600 |
## Used by
[php-fpm](../php-fpm/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/php/dictionaries/20_php.xml b/seed/php/dictionaries/20_php.xml
index 026882ef..ed80b0f8 100644
--- a/seed/php/dictionaries/20_php.xml
+++ b/seed/php/dictionaries/20_php.xml
@@ -7,37 +7,28 @@
-
+
32
-
+
16
-
+
30
-
+
60
-
+
512
-
- False
-
-
+
3600
-
- False
-
-
- Europe/Paris
-
-
+
True
-
+
True
diff --git a/seed/php/templates/php.ini b/seed/php/templates/php.ini
index 3657cbbc..8e670bea 100644
--- a/seed/php/templates/php.ini
+++ b/seed/php/templates/php.ini
@@ -521,11 +521,7 @@ error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
; Development Value: On
; Production Value: Off
; https://php.net/display-errors
-{% if general.php.php_display_errors %}
-display_errors = On
-{% else %}
display_errors = Off
-{% endif %}
; The display of errors which occur during PHP's startup sequence are handled
; separately from display_errors. We strongly recommend you set this to 'off'
@@ -963,7 +959,7 @@ cli_server.color = On
; https://php.net/date.timezone
;date.timezone =
;>GNUNUX
-date.timezone = "{{ general.php.time_zone }}"
+date.timezone = "{{ general.base.time_zone }}"
;mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comment |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
#### Piwigo
-| Parameter | Comments |
+| Parameter | Comment |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| **[general.piwigo.piwigo_admin_email](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`mail`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Adresse courriel de l'administrateur Piwigo.
**Example:** admin@example.net |
@@ -43,79 +44,29 @@ This family is a leadership.
## Variables
-### Général
+### General
-#### Piwigo
-
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
-| **[general.piwigo.piwigo_title](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Titre de l'album.
**Default:** Album photographique |
-
-
-
-## Variables for expert
-
-### Général
-
-#### PHP
-
-Paramètrage avancé de PHP.
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST.
Valeur en Mo.
**Default:** 32 |
-| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale d'un fichier à charger.
Valeur en Mo.
**Default:** 16 |
-| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Temps maximal d'exécution d'un script.
Valeur en secondes.
**Default:** 30 |
-| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée maximale pour analyser les données d'entrée.
Valeur en secondes.
**Default:** 60 |
-| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille mémoire maximale qu'un script est autorisé à allouer.
Valeur en Mo.
**Default:** 512 |
-| **[general.php.php_display_errors](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Affichage des erreurs à l'écran.
**Default:** False |
-| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée de vie des données sur le serveur.
Valeur en secondes.
**Default:** 3600 |
-| **[general.php.php_browscap](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer la directive de configuration browscap.
La directive de configuration browscap permet d'obtenir plus d'information sur les capacités du navigateur client grâce à la fonction get_browser().
**Default:** False |
-| **[general.php.time_zone](dictionaries/20_php.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Fuseau horaire.
**Default:** Europe/Paris |
-| **[general.php.php_enable_output_buffering](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer les tampons de sortie.
**Default:** True |
-| **[general.php.php_disable_pcntl](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Désactiver PCNTL.
**Default:** True |
-
-#### NGINX
-
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
-
-#### Annuaire OpenLDAP
+#### OpenLDAP directory
##### Client
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de la famille LDAP. |
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
+| Parameter | Comment |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|
+| **[general.ldap.client.ldapclient_family](dictionaries/21_ldap-client.xml)**
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Restrict service configuration for a LDAP family.
"all" for all families. |
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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. |
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
#### OAuth2 client
-| Parameter | Comments |
+| Parameter | Comment |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| **[general.oauth2_client.oauth2_client_name](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Album
**Example:** example |
| **[general.oauth2_client.oauth2_client_description](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Album photographique Piwigo
**Example:** Example description |
@@ -128,25 +79,60 @@ This family is a leadership.
| **[general.oauth2_client.external.oauth2_client_external](dictionaries/30_oauth2_client.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
| **[general.oauth2_client.external.oauth2_client_family](dictionaries/30_oauth2_client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** users |
-| Parameter | Comments |
+| Parameter | Comment |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
| **[general.oauth2_client.oauth2_client_category](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Diffusion |
| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_image.png |
+#### Piwigo
+
+| Parameter | Comment |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
+| **[general.piwigo.piwigo_title](dictionaries/31_piwigo.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Titre de l'album.
**Default:** Album photographique |
+
+
+
+## Variables for expert
+
+### General
+
+#### PHP
+
+Paramètrage avancé de PHP.
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
+| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum size of POST data that PHP will accept.
Value in Mb.
**Default:** 32 |
+| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum allowed size for uploaded files.
Value in Mb.
**Default:** 16 |
+| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 30 |
+| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 60 |
+| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of memory a script may consume.
Value in Mb.
**Default:** 512 |
+| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Data will be seen as 'garbage' and potentially cleaned up after this delay.
Value in seconds.
**Default:** 3600 |
+
+#### NGINX
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **MariaDB**
-- **SMTP**
-- **LDAP**
-- **ReverseProxy**
-- **Redis**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [LDAP](../README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [Redis](../README.Redis.md): Automaticly create account and connexion to a Redis server.
+- [MariaDB](../README.MariaDB.md): Automaticly create account and connexion to a MariaDB server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -159,10 +145,10 @@ piwigo:
- ldap
- localdns
- mariadb
+ - oauth2
+ - redis
- reverseproxy
- smtp
- - redis
- - oauth2
values:
general.revprox.revprox_client.revprox_client_external_domainnames:
- service.example.net
@@ -175,25 +161,23 @@ piwigo:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [mariadb-client](../mariadb-client/README.md)
-- [ldap-client](../ldap-client/README.md)
-- [redis-client](../redis-client/README.md)
- - [redis-common](../redis-common/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [php-fpm](../php-fpm/README.md)
- - [php](../php/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [mariadb-client](../mariadb-client/README.md): Application service needs interact with a MariaDB server.
+- [ldap-client](../ldap-client/README.md): Application service needs interact with a LDAP server.
+- [redis-client](../redis-client/README.md): Application service needs interact with a Redis server.
+ - [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [php-fpm](../php-fpm/README.md): PHP FPM.
+ - [php](../php/README.md): PHP, a popular general-purpose scripting language.
diff --git a/seed/pki-tls/README.md b/seed/pki-tls/README.md
index 291e3777..52bef95c 100644
--- a/seed/pki-tls/README.md
+++ b/seed/pki-tls/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# pki-tls
## Synopsis
@@ -12,5 +14,3 @@ Autosign PKI or Let's encrypt support for TLS certificates.
## Used by
[base-machine](../base-machine/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/postfix-lmtp-relay/README.md b/seed/postfix-lmtp-relay/README.md
index 16864935..660897d6 100644
--- a/seed/postfix-lmtp-relay/README.md
+++ b/seed/postfix-lmtp-relay/README.md
@@ -3,20 +3,15 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# postfix-lmtp-relay
## Synopsis
-Postfix, the mail server, as LMTP relay.
-[Software's website.](http://www.postfix.org/)
+[Postfix, the mail server, as LMTP relay.](http://www.postfix.org/)
## Used by
[postfix-relay](../postfix-relay/README.md)
-
-## Supplier
-
-[relay-lmtp-client](../relay-lmtp-client/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/postfix-lmtp-relay/extras/lmtp/00_lmtp.xml b/seed/postfix-lmtp-relay/extras/lmtp/00_lmtp.xml
index d2f3e879..64662bf8 100644
--- a/seed/postfix-lmtp-relay/extras/lmtp/00_lmtp.xml
+++ b/seed/postfix-lmtp-relay/extras/lmtp/00_lmtp.xml
@@ -1,9 +1,9 @@
-
-
-
+
+
+
diff --git a/seed/postfix-relay/README.md b/seed/postfix-relay/README.md
index ebd48a41..bf5fb1a2 100644
--- a/seed/postfix-relay/README.md
+++ b/seed/postfix-relay/README.md
@@ -3,33 +3,40 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# postfix-relay
## Synopsis
-Postfix, the mail server, as relay.
-[Software's website.](http://www.postfix.org/)
+[Postfix, the mail server, as relay.](http://www.postfix.org/)
+The mail relay allows the various internal services to communicate with the other services.
+It is also possible to receive from outside or send emails to the outside.
-## Variables
+## Basic variables
-### Général
+### General
#### Postfix mail server
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.postfix.postfix_mail_hostname](dictionaries/30_postfix.xml)**
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine extérieur du serveur de courriel.
Cette variable est obligatoire pour recevoir des courriels depuis l'extérieur. |
-| **[general.postfix.postfix_crt_provider](dictionaries/30_postfix.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autorité de certification signant le certificat du domaine extérieur.
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
+| Parameter | Comments |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **[general.postfix.postfix_mail_hostname](dictionaries/30_postfix.xml)**
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External email server domain name.
This variable is mandatory if mail server needs to interact with external area. |
+| **[general.postfix.postfix_crt_provider](dictionaries/30_postfix.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type of certificate autority signing external certificate.
The certificate can be self-signed (therefore invalid by default for the client) or obtained via the Let's Encrypt service (generally valid for the client).
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
+
## Requirements services
-- **ExternalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [ExternalDNS](../README.ExternalDNS.md): DNS forwarder for all DNS zones.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -40,25 +47,33 @@ postfix-relay:
applicationservice: postfix-relay
provider_zone: smtp
zones_name:
- - localdns
+ - externaldns
```
## Dependances
-- [base-fedora-35](../base-fedora-35/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [dns-external](../dns-external/README.md)
-- [postfix-lmtp-relay](../postfix-lmtp-relay/README.md)
+- [base-fedora-35](../base-fedora-35/README.md): Base information of a Fedora 35.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [dns-external](../dns-external/README.md): DNS client with resolution on all zones (especially outside).
+- [postfix-lmtp-relay](../postfix-lmtp-relay/README.md): Postfix, the mail server, as LMTP relay.
-## Supplier
+## Useful for services
-[relay-mail-client](../relay-mail-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [dovecot](../dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [lemonldap](../lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [vaultwarden](../vaultwarden/README.md): Vaultwarden, a password manager.
diff --git a/seed/postfix-relay/applicationservice.yml b/seed/postfix-relay/applicationservice.yml
index 2a3d1ce2..7e0789d1 100644
--- a/seed/postfix-relay/applicationservice.yml
+++ b/seed/postfix-relay/applicationservice.yml
@@ -1,5 +1,8 @@
format: '0.1'
description: Postfix, the mail server, as relay
+help: |
+ The mail relay allows the various internal services to communicate with the other services.
+ It is also possible to receive from outside or send emails to the outside.
website: http://www.postfix.org/
depends:
- base-fedora-35
diff --git a/seed/postfix-relay/dictionaries/30_postfix.xml b/seed/postfix-relay/dictionaries/30_postfix.xml
index e6367151..a6abec8e 100644
--- a/seed/postfix-relay/dictionaries/30_postfix.xml
+++ b/seed/postfix-relay/dictionaries/30_postfix.xml
@@ -31,27 +31,26 @@
-
- 25
-
+
-
-
+
+
self-signed
self-signed
letsencrypt
-
-
-
-
-
+
+
+
+
+
+
-
+
@@ -76,5 +75,13 @@
True
incoming_ports
+
+
+ 25
+ postfix_mail_hostname
+
+ True
+ outgoing_ports
+
diff --git a/seed/postfix-relay/templates/postfix.service b/seed/postfix-relay/templates/postfix.service
index 54ca4a31..d4c60be6 100644
--- a/seed/postfix-relay/templates/postfix.service
+++ b/seed/postfix-relay/templates/postfix.service
@@ -2,7 +2,7 @@
ExecStartPre=/usr/sbin/postmap /etc/postfix/lmtp
ExecStartPre=/usr/sbin/postmap -F /etc/postfix/sni
{% for local in general.postfix.postfix_relay_authentifications %}
-{% set user = local|normalize_family %}
+{% set user = general.postfix['local_authentification_' + user]['local_authentification_username_' + user] %}
{% set password = general.postfix['local_authentification_' + user]['local_authentification_password_' + user] %}
{% set ip = general.postfix['local_authentification_' + user]['postfix_relay_ip_' + user] %}
ExecStartPre=-/usr/bin/bash -c "echo {{ password }} | /usr/sbin/saslpasswd2 -u {{ ip }} {{ user }} -p"
diff --git a/seed/postgresql-client/README.md b/seed/postgresql-client/README.md
index cdb79b1f..db56626b 100644
--- a/seed/postgresql-client/README.md
+++ b/seed/postgresql-client/README.md
@@ -3,27 +3,14 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# postgresql-client
## Synopsis
-Application service needs interact with a Postgresql server.
-[Software's website.](https://www.postgresql.org)
-
-
-
-## Variables for expert
-
-### Général
-
-#### PostgreSQL
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
-| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
+[Application service needs interact with a Postgresql server.](https://www.postgresql.org)
## Used by
@@ -35,9 +22,3 @@ Application service needs interact with a Postgresql server.
- [roundcube](../roundcube/README.md)
- [vaultwarden](../vaultwarden/README.md)
- [nextcloud](../nextcloud/README.md)
-
-## Provider
-
-[postgresql](../postgresql/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/postgresql-client/dictionaries/23_postgresql.xml b/seed/postgresql-client/dictionaries/23_postgresql.xml
index d70417a8..11d9604f 100644
--- a/seed/postgresql-client/dictionaries/23_postgresql.xml
+++ b/seed/postgresql-client/dictionaries/23_postgresql.xml
@@ -10,11 +10,11 @@
-
-
-
-
-
+
+
+
+
+
apache
diff --git a/seed/postgresql/README.md b/seed/postgresql/README.md
index c1a841e1..5e273571 100644
--- a/seed/postgresql/README.md
+++ b/seed/postgresql/README.md
@@ -3,18 +3,19 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# postgresql
## Synopsis
-Postgresql, a database.
-[Software's website.](https://www.postgresql.org)
+[Postgresql, a database.](https://www.postgresql.org)
## Variables
-### Général
+### General
#### PostgreSQL
@@ -39,23 +40,16 @@ Paramétrage du serveur de gestion de bases de données PostgreSQL.
| **[general.postgresql.pg_effective_cache_size](dictionaries/22_postgresql.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille du cache.
Initialise l'estimation faite par le planificateur pour le nombre de bloc de 8ko réelle du cache disque disponible pour une requête.
**Default:** 4 |
| **[general.postgresql.pg_effective_cache_size_unit](dictionaries/22_postgresql.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Unité de la taille du cache.
**Choices:**
- `MB`
- `kB`
- `GB` ← default |
-### Accounts
-
-#### Account for *suffix value*
-
-This a dynamic family generated from the variable "accounts.remotes".
-
-| Parameter | Comments |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|
-| **[accounts.remote_*suffix value*.remote_ip_*suffix value*](extras/accounts/00_accounts.xml)**
mandatory
**Type:** [`ip`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Remote IP .
**Default:** *calculated* |
-
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -71,18 +65,24 @@ postgresql:
## Dependances
-- [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Supplier
+## Useful for services
-[postgresql-client](../postgresql-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
+- [vaultwarden](../vaultwarden/README.md): Vaultwarden, a password manager.
diff --git a/seed/postgresql/extras/accounts/00_accounts.xml b/seed/postgresql/extras/accounts/00_accounts.xml
index ff655c4b..8c38232a 100644
--- a/seed/postgresql/extras/accounts/00_accounts.xml
+++ b/seed/postgresql/extras/accounts/00_accounts.xml
@@ -1,12 +1,12 @@
-
-
+
+
-
-
-
+
+
+
diff --git a/seed/postgresql/templates/postgresql.conf b/seed/postgresql/templates/postgresql.conf
index 73316079..84b31639 100644
--- a/seed/postgresql/templates/postgresql.conf
+++ b/seed/postgresql/templates/postgresql.conf
@@ -627,7 +627,7 @@ log_destination = 'syslog'
#FIXME en dure ?
#>GNUNUX
#log_timezone = 'GMT'
-log_timezone = 'Europe/Paris'
+log_timezone = '{{ general.base.time_zone }}'
#GNUNUX
-#FIXME en dure ?
-timezone = 'Europe/Paris'
+timezone = '{{ general.base.time_zone }}'
#
-
+
diff --git a/seed/provider-systemd-machined/README.md b/seed/provider-systemd-machined/README.md
index 4be5dc95..039eea50 100644
--- a/seed/provider-systemd-machined/README.md
+++ b/seed/provider-systemd-machined/README.md
@@ -3,51 +3,21 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# provider-systemd-machined
## Synopsis
-Machine started in Systemd Machined environment.
-[Software's website.](https://www.freedesktop.org/wiki/Software/systemd/machined/)
-
-
-## Variables
-
-### Général
-
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|
-| **[general.use_systemd_repart](dictionaries/16_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** False |
-
-#### network
-
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
-| **[general.network.netwokd_interface_name_type](dictionaries/16_machined.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** host |
-
-## Variables for expert
-
-### Général
-
-#### network
-
-| Parameter | Comments |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------|
-| **[general.network.zones_list](dictionaries/16_machined.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | |
+[Machine started in Systemd Machined environment.](https://www.freedesktop.org/wiki/Software/systemd/machined/)
## Dependances
-- [systemd](../systemd/README.md)
- - [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-
-## Provider
-
-[host-systemd-machined](../host-systemd-machined/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
diff --git a/seed/provider-systemd-machined/dictionaries/16_machined.xml b/seed/provider-systemd-machined/dictionaries/16_machined.xml
index a32b0a6d..48d9b4de 100644
--- a/seed/provider-systemd-machined/dictionaries/16_machined.xml
+++ b/seed/provider-systemd-machined/dictionaries/16_machined.xml
@@ -26,16 +26,16 @@
/var/lib/risotto/journals
-
+
False
-
+
host
-
+
True
diff --git a/seed/redis-client/README.md b/seed/redis-client/README.md
index b0275c8c..4abffe61 100644
--- a/seed/redis-client/README.md
+++ b/seed/redis-client/README.md
@@ -3,30 +3,18 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# redis-client
## Synopsis
-Application service needs interact with a Redis server.
-[Software's website.](https://redis.io/)
-
-
-
-## Variables for expert
-
-### Général
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
+[Application service needs interact with a Redis server.](https://redis.io/)
## Dependances
-- [redis-common](../redis-common/README.md)
+- [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
## Used by
@@ -35,9 +23,3 @@ Application service needs interact with a Redis server.
- [forgejo](../forgejo/README.md)
- [roundcube](../roundcube/README.md)
- [nextcloud](../nextcloud/README.md)
-
-## Provider
-
-[redis](../redis/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/redis-client/dictionaries/23_redis.xml b/seed/redis-client/dictionaries/23_redis.xml
index 8b58468f..58b48b14 100644
--- a/seed/redis-client/dictionaries/23_redis.xml
+++ b/seed/redis-client/dictionaries/23_redis.xml
@@ -6,12 +6,12 @@
-
-
-
-
-
-
+
+
+
+
+
+
apache
diff --git a/seed/redis-common/README.md b/seed/redis-common/README.md
index eccb4583..225399c8 100644
--- a/seed/redis-common/README.md
+++ b/seed/redis-common/README.md
@@ -3,17 +3,16 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# redis-common
## Synopsis
-Redis, an in-memory data structure store.
-[Software's website.](https://redis.io/)
+[Redis, an in-memory data structure store.](https://redis.io/)
## Used by
- [redis](../redis/README.md)
- [redis-client](../redis-client/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/redis/README.md b/seed/redis/README.md
index 8832d3e0..d3ac0a7b 100644
--- a/seed/redis/README.md
+++ b/seed/redis/README.md
@@ -3,18 +3,19 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# redis
## Synopsis
-Redis, an in-memory data structure store.
-[Software's website.](https://redis.io/)
+[Redis, an in-memory data structure store.](https://redis.io/)
## Variables
-### Général
+### General
#### Redis
@@ -29,23 +30,16 @@ Configuration du service de cache Redis.
| **[general.redis.redis_tcp_keepalive](dictionaries/90_redis.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Intervalle entre le dernier envoi de paquet TCP et la réponse ACK.
La valeur est en seconde.
**Default:** 300 |
| **[general.redis.redis_max_clients](dictionaries/90_redis.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nombre de client maximum autorisé.
**Default:** 10000 |
-### Accounts
-
-#### remote_*suffix value*
-
-This a dynamic family generated from the variable "accounts.remotes".
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|
-| **[accounts.remote_*suffix value*.ip_*suffix value*](extras/accounts/00_accounts.xml)**
mandatory
**Type:** [`ip`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | **Default:** *calculated* |
-
## Requirements services
-- **LocalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -61,19 +55,22 @@ redis:
## Dependances
-- [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [redis-common](../redis-common/README.md)
+- [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
-## Supplier
+## Useful for services
-[redis-client](../redis-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
diff --git a/seed/redis/extras/accounts/00_accounts.xml b/seed/redis/extras/accounts/00_accounts.xml
index 007576cd..88af7de4 100644
--- a/seed/redis/extras/accounts/00_accounts.xml
+++ b/seed/redis/extras/accounts/00_accounts.xml
@@ -1,12 +1,12 @@
-
-
+
+
-
-
-
+
+
+
diff --git a/seed/relay-lmtp-client/README.md b/seed/relay-lmtp-client/README.md
index 2cf2eca0..634f41cc 100644
--- a/seed/relay-lmtp-client/README.md
+++ b/seed/relay-lmtp-client/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# relay-lmtp-client
## Synopsis
@@ -11,15 +13,9 @@ Application service needs interact with a Postfix server with LMTP protocol.
## Dependances
-- [relay-mail-client](../relay-mail-client/README.md)
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
## Used by
- [mailman](../mailman/README.md)
- [dovecot](../dovecot/README.md)
-
-## Provider
-
-[postfix-lmtp-relay](../postfix-lmtp-relay/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/relay-lmtp-client/dictionaries/30_lmtp.xml b/seed/relay-lmtp-client/dictionaries/30_lmtp.xml
index 888424ff..8bc2d79a 100644
--- a/seed/relay-lmtp-client/dictionaries/30_lmtp.xml
+++ b/seed/relay-lmtp-client/dictionaries/30_lmtp.xml
@@ -1,7 +1,7 @@
-
+
diff --git a/seed/relay-mail-client/README.md b/seed/relay-mail-client/README.md
index eca8416a..e0f2c4f4 100644
--- a/seed/relay-mail-client/README.md
+++ b/seed/relay-mail-client/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# relay-mail-client
## Synopsis
@@ -20,9 +22,3 @@ Client SMTP.
- [relay-lmtp-client](../relay-lmtp-client/README.md)
- [nextcloud](../nextcloud/README.md)
- [lemonldap](../lemonldap/README.md)
-
-## Provider
-
-[postfix-relay](../postfix-relay/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/relay-mail-client/dictionaries/20_smtp_client.xml b/seed/relay-mail-client/dictionaries/20_smtp_client.xml
index 2cbcf241..014d08e5 100644
--- a/seed/relay-mail-client/dictionaries/20_smtp_client.xml
+++ b/seed/relay-mail-client/dictionaries/20_smtp_client.xml
@@ -7,11 +7,11 @@
-
+
-
-
+
+
diff --git a/seed/resolved/README.md b/seed/resolved/README.md
index eec0fc5c..6a0c3cd0 100644
--- a/seed/resolved/README.md
+++ b/seed/resolved/README.md
@@ -3,16 +3,15 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# resolved
## Synopsis
-Resolved.
-[Software's website.](https://systemd.io/)
+[Resolved.](https://systemd.io/)
## Used by
[systemd](../systemd/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/resolved/dictionaries/20_resolved.xml b/seed/resolved/dictionaries/20_resolved.xml
index f0ca94f3..e31c17ef 100644
--- a/seed/resolved/dictionaries/20_resolved.xml
+++ b/seed/resolved/dictionaries/20_resolved.xml
@@ -9,7 +9,7 @@
-
+
diff --git a/seed/reverse-proxy-client/README.md b/seed/reverse-proxy-client/README.md
index c77c9588..655c58b9 100644
--- a/seed/reverse-proxy-client/README.md
+++ b/seed/reverse-proxy-client/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# reverse-proxy-client
## Synopsis
@@ -11,33 +13,33 @@ Application service needs interact with a a reverse proxy server.
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comments |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
+## Variables
-## Variables for expert
-
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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. |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
+
## Used by
@@ -50,9 +52,3 @@ This family is a leadership.
- [nginx-https](../nginx-https/README.md)
- [vaultwarden](../vaultwarden/README.md)
- [apache](../apache/README.md)
-
-## Provider
-
-[nginx-reverse-proxy](../nginx-reverse-proxy/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/reverse-proxy-client/dictionaries/21_revprox_client.xml b/seed/reverse-proxy-client/dictionaries/21_revprox_client.xml
index cee5ce49..afc1746e 100644
--- a/seed/reverse-proxy-client/dictionaries/21_revprox_client.xml
+++ b/seed/reverse-proxy-client/dictionaries/21_revprox_client.xml
@@ -10,15 +10,15 @@
-
-
-
+
+
+
/
+
False
-
diff --git a/seed/roundcube/README.md b/seed/roundcube/README.md
index 78d3d2c1..2719f17e 100644
--- a/seed/roundcube/README.md
+++ b/seed/roundcube/README.md
@@ -3,17 +3,18 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# roundcube
## Synopsis
-Roundcube, a webmail.
-[Software's website.](https://roundcube.net/)
+[Roundcube, a webmail.](https://roundcube.net/)
## Basic variables
-### Général
+### General
#### Interface web de consultation des courriels Roundcube
@@ -28,7 +29,27 @@ This family is a leadership.
## Variables
-### Général
+### General
+
+#### OAuth2 client
+
+| Parameter | Comment |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
+| **[general.oauth2_client.oauth2_client_name](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Courriel
**Example:** example |
+| **[general.oauth2_client.oauth2_client_description](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Consulter ces courriels avec Roundcube
**Example:** Example description |
+| **[general.oauth2_client.oauth2_client_login](dictionaries/30_oauth2_client.xml)**
**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. |
+
+##### external
+
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
+| **[general.oauth2_client.external.oauth2_client_external](dictionaries/31_roundcube.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
+| **[general.oauth2_client.external.oauth2_client_family](dictionaries/31_roundcube.xml)**
multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** *calculated* |
+
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
+| **[general.oauth2_client.oauth2_client_category](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Diffusion |
+| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_email.png |
#### Interface web de consultation des courriels Roundcube
@@ -42,95 +63,45 @@ This family is a leadership.
## Variables for expert
-### Général
+### General
#### PHP
Paramètrage avancé de PHP.
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST.
Valeur en Mo.
**Default:** 32 |
-| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale d'un fichier à charger.
Valeur en Mo.
**Default:** 16 |
-| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Temps maximal d'exécution d'un script.
Valeur en secondes.
**Default:** 30 |
-| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée maximale pour analyser les données d'entrée.
Valeur en secondes.
**Default:** 60 |
-| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille mémoire maximale qu'un script est autorisé à allouer.
Valeur en Mo.
**Default:** 512 |
-| **[general.php.php_display_errors](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Affichage des erreurs à l'écran.
**Default:** False |
-| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Durée de vie des données sur le serveur.
Valeur en secondes.
**Default:** 3600 |
-| **[general.php.php_browscap](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer la directive de configuration browscap.
La directive de configuration browscap permet d'obtenir plus d'information sur les capacités du navigateur client grâce à la fonction get_browser().
**Default:** False |
-| **[general.php.time_zone](dictionaries/20_php.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Fuseau horaire.
**Default:** Europe/Paris |
-| **[general.php.php_enable_output_buffering](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Activer les tampons de sortie.
**Default:** True |
-| **[general.php.php_disable_pcntl](dictionaries/20_php.xml)**
mandatory
**Type:** [`boolean`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Désactiver PCNTL.
**Default:** True |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
+| **[general.php.php_post_max_size](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum size of POST data that PHP will accept.
Value in Mb.
**Default:** 32 |
+| **[general.php.php_upload_max_filesize](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum allowed size for uploaded files.
Value in Mb.
**Default:** 16 |
+| **[general.php.php_max_execution_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 30 |
+| **[general.php.php_max_input_time](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of time each script may spend parsing request data.
Value in seconds.
**Default:** 60 |
+| **[general.php.php_memory_limit](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Maximum amount of memory a script may consume.
Value in Mb.
**Default:** 512 |
+| **[general.php.php_session_gc_maxlifetime](dictionaries/20_php.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Data will be seen as 'garbage' and potentially cleaned up after this delay.
Value in seconds.
**Default:** 3600 |
#### NGINX
-Paramétrage global de NGINX.
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Longueur maximum pour un nom de domaine.
**Choices:**
- `128` ← default
- `64`
- `32` |
-| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille maximale des données reçues par la méthode POST (en Mo).
**Default:** 32 |
-
-#### Annuaire OpenLDAP
-
-##### Client
-
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
-| **[general.ldap.client.ldapclient_base_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_search_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_group_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des groupes.
**Default:** *calculated* |
-| **[general.ldap.client.ldapclient_user_dn](dictionaries/21_ldap-client.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
**Default:** *calculated* |
-
-#### PostgreSQL
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
-| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
-
-#### Redis
-
-| Parameter | Comments |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
-| **[general.redis.redis_client_username](dictionaries/23_redis.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur.
**Default:** *calculated* |
-| **[general.redis.redis_client_password](dictionaries/23_redis.xml)**
mandatory
**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.
**Default:** *calculated* |
-
-#### OAuth2 client
-
-| Parameter | Comments |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
-| **[general.oauth2_client.oauth2_client_name](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client name.
**Default:** Courriel
**Example:** example |
-| **[general.oauth2_client.oauth2_client_description](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 client description.
**Default:** Consulter ces courriels avec Roundcube
**Example:** Example description |
-| **[general.oauth2_client.oauth2_client_login](dictionaries/30_oauth2_client.xml)**
**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. |
-
-##### external
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
-| **[general.oauth2_client.external.oauth2_client_external](dictionaries/31_roundcube.xml)**
mandatory, multiple
**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.
**Default:** *calculated* |
-| **[general.oauth2_client.external.oauth2_client_family](dictionaries/31_roundcube.xml)**
multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 family.
**Default:** *calculated* |
-
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|
-| **[general.oauth2_client.oauth2_client_category](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 category.
**Default:** Diffusion |
-| **[general.oauth2_client.oauth2_client_logo](dictionaries/31_roundcube.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | OAuth2 logo.
**Default:** silique_email.png |
+| Parameter | Comment |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| **[general.nginx.nginx_hash_bucket_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The bucket size for the server names hash tables.
**Choices:**
- `128` ← default
- `64`
- `32` |
+| **[general.nginx.nginx_post_max_size](dictionaries/21_nginx.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body.
This value is in Mb.
**Default:** 32 |
## Requirements services
-- **LocalDNS**
-- Journald
-- **IMAP**
-- **LDAP**
-- **ReverseProxy**
-- **Postgresql**
-- **Redis**
-- **OAuth2**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [LDAP](../README.LDAP.md): Automaticly create account and connexion to a LDAP server.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+- [OAuth2](../README.OAuth2.md): Remote clients needing to verify OAuth2 account.
+- [Redis](../README.Redis.md): Automaticly create account and connexion to a Redis server.
+- [IMAP](../README.IMAP.md): IMAP server connexion.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -140,13 +111,13 @@ Zone names are provided as examples. Think about adapting with the value of prov
roundcube:
applicationservice: roundcube
zones_name:
+ - imap
- ldap
- localdns
- - reverseproxy
- - imap
- - redis
- oauth2
- postgresql
+ - redis
+ - reverseproxy
values:
general.roundcube.roundcube_domain.roundcube_domains:
- webmail.example.net
@@ -156,25 +127,23 @@ roundcube:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [imap-client](../imap-client/README.md)
-- [redis-client](../redis-client/README.md)
- - [redis-common](../redis-common/README.md)
-- [oauth2-client](../oauth2-client/README.md)
-- [nginx-https](../nginx-https/README.md)
- - [nginx-common](../nginx-common/README.md)
- - [reverse-proxy-client](../reverse-proxy-client/README.md)
-- [php-fpm](../php-fpm/README.md)
- - [php](../php/README.md)
-- [ldap-client](../ldap-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [imap-client](../imap-client/README.md): Application service needs interact with an IMAP server.
+- [redis-client](../redis-client/README.md): Application service needs interact with a Redis server.
+ - [redis-common](../redis-common/README.md): Redis, an in-memory data structure store.
+- [oauth2-client](../oauth2-client/README.md): Application service needs interact with a Oauth2 server.
+- [nginx-https](../nginx-https/README.md): Nginx as HTTPS web site.
+ - [nginx-common](../nginx-common/README.md): Nginx common configuration.
+ - [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
+- [php-fpm](../php-fpm/README.md): PHP FPM.
+ - [php](../php/README.md): PHP, a popular general-purpose scripting language.
+- [ldap-client](../ldap-client/README.md): Application service needs interact with a LDAP server.
diff --git a/seed/speedtest-rs/README.md b/seed/speedtest-rs/README.md
index a04828fc..a8ef8f9e 100644
--- a/seed/speedtest-rs/README.md
+++ b/seed/speedtest-rs/README.md
@@ -3,51 +3,55 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# speedtest-rs
## Synopsis
-Speedtest-rs, a very lightweight Speedtest.
-[Software's website.](https://cloud.silique.fr/gitea/Silique/speedtest-rs)
+[Speedtest-rs, a very lightweight Speedtest.](https://cloud.silique.fr/gitea/Silique/speedtest-rs)
## Basic variables
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
-| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**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.
**Example:** service.example.net |
-| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**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. |
+| Parameter | Comments |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_external_domainnames](dictionaries/21_revprox_client.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Service external domain name.
**Example:** service.example.net |
+| **[general.revprox.revprox_client.revprox_client_location](dictionaries/21_revprox_client.xml)**
mandatory
**Type:** [`filename`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | URI to route request to the correct service.
**Default:** / |
+## Variables
-## Variables for expert
-
-### Général
+### General
#### Reverse proxy
-##### Point d'entrée des clients
+##### Clients configuration
This family is a leadership.
-| Parameter | Comments |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|
-| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**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. |
+| Parameter | Comments |
+|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+| **[general.revprox.revprox_client.revprox_client_max_body_size](dictionaries/21_revprox_client.xml)**
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | The maximum allowed size of the client request body. |
+
## Requirements services
-- **LocalDNS**
-- Journald
-- **ReverseProxy**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -66,15 +70,13 @@ speedtest-rs:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
diff --git a/seed/systemd/README.md b/seed/systemd/README.md
index 3529d6c1..fb458ce1 100644
--- a/seed/systemd/README.md
+++ b/seed/systemd/README.md
@@ -3,27 +3,26 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# systemd
## Synopsis
-Systemd, a system and service manager.
-[Software's website.](https://systemd.io/)
+[Systemd, a system and service manager.](https://systemd.io/)
## Dependances
-- [base-machine](../base-machine/README.md)
- - [base](../base/README.md)
- - [dns-local](../dns-local/README.md)
- - [pki-tls](../pki-tls/README.md)
-- [journald](../journald/README.md)
-- [resolved](../resolved/README.md)
+- [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+- [journald](../journald/README.md): Journald.
+- [resolved](../resolved/README.md): Resolved.
## Used by
- [base-fedora](../base-fedora/README.md)
- [base-debian](../base-debian/README.md)
- [provider-systemd-machined](../provider-systemd-machined/README.md)
-
-[All applications services for this dataset.](../README.md)
diff --git a/seed/systemd/dictionaries/15_systemd.xml b/seed/systemd/dictionaries/15_systemd.xml
index 12317215..f1f0f04e 100644
--- a/seed/systemd/dictionaries/15_systemd.xml
+++ b/seed/systemd/dictionaries/15_systemd.xml
@@ -25,7 +25,7 @@
-
+
/secrets/root.pwd
/tmpfiles.d/risotto-volatile.conf
diff --git a/seed/systemd/templates/systemd-firstboot.service b/seed/systemd/templates/systemd-firstboot.service
index e3afeb2f..6670dc6e 100644
--- a/seed/systemd/templates/systemd-firstboot.service
+++ b/seed/systemd/templates/systemd-firstboot.service
@@ -1,4 +1,4 @@
[Service]
ExecStart=
-ExecStart=/usr/bin/systemd-firstboot --root-password-file=/usr/local/lib/secrets/root.pwd --locale=fr_FR.UTF-8 --timezone=Europe/Paris
+ExecStart=/usr/bin/systemd-firstboot --root-password-file=/usr/local/lib/secrets/root.pwd --locale=fr_FR.UTF-8 --timezone={{ general.base.time_zone }}
ExecStart=/usr/bin/systemd-firstboot --copy
diff --git a/seed/unbound/README.md b/seed/unbound/README.md
index 9153704b..641f5529 100644
--- a/seed/unbound/README.md
+++ b/seed/unbound/README.md
@@ -3,17 +3,18 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# unbound
## Synopsis
-Unbound, a validating, recursive, caching DNS resolver.
-[Software's website.](https://www.nlnetlabs.nl/projects/unbound/about/)
+[Unbound, a validating, recursive, caching DNS resolver.](https://www.nlnetlabs.nl/projects/unbound/about/)
## Basic variables
-### Général
+### General
#### Résolveur DNS
@@ -25,10 +26,9 @@ Unbound, a validating, recursive, caching DNS resolver.
## Requirements services
-- **ExternalDNS**
-- Journald
+### Optionals
-**bold**: provider is mandatory
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -38,8 +38,6 @@ Zone names are provided as examples. Think about adapting with the value of prov
unbound:
applicationservice: unbound
provider_zone: externaldns
- zones_name:
- - localdns
values:
general.dns_resolver.unbound_default_forwards:
- 9.9.9.9
@@ -47,20 +45,20 @@ unbound:
## Dependances
-- [dns-external](../dns-external/README.md)
-- [base-fedora-37](../base-fedora-37/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
+- [dns-external](../dns-external/README.md): DNS client with resolution on all zones (especially outside).
+- [base-fedora-37](../base-fedora-37/README.md): Base information of a Fedora 37.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
-## Suppliers
+## Useful for services
-- [dns-external](../dns-external/README.md)
-- [nsd-local](../nsd-local/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [nsd-local](../nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [postfix-relay](../postfix-relay/README.md): Postfix, the mail server, as relay.
+- [znc](../znc/README.md): ZNC, a bouncer IRC.
diff --git a/seed/unbound/dictionaries/20_unbound.xml b/seed/unbound/dictionaries/20_unbound.xml
index 342789ac..92106e52 100644
--- a/seed/unbound/dictionaries/20_unbound.xml
+++ b/seed/unbound/dictionaries/20_unbound.xml
@@ -17,7 +17,7 @@
-
+
udp:53
@@ -26,9 +26,8 @@
-
-
-
+
+
diff --git a/seed/vaultwarden/README.md b/seed/vaultwarden/README.md
index 025b197f..5974042e 100644
--- a/seed/vaultwarden/README.md
+++ b/seed/vaultwarden/README.md
@@ -3,17 +3,18 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# vaultwarden
## Synopsis
-Vaultwarden, a password manager.
-[Software's website.](https://github.com/dani-garcia/vaultwarden)
+[Vaultwarden, a password manager.](https://github.com/dani-garcia/vaultwarden)
## Basic variables
-### Général
+### General
#### Vaultwarden
@@ -24,7 +25,7 @@ Vaultwarden, a password manager.
## Variables
-### Général
+### General
#### Vaultwarden
@@ -34,29 +35,19 @@ Vaultwarden, a password manager.
| **[general.vaultwarden.vaultwarden_length](dictionaries/40_vaultwarden.xml)**
mandatory
**Type:** [`number`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Taille par défaut du mot de passe.
**Default:** 20 |
| **[general.vaultwarden.vaultwarden_org_name](dictionaries/40_vaultwarden.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de l'organisation lors de l'envoi des invitations.
**Default:** Vaultwarden |
-## Variables for expert
-
-### Général
-
-#### PostgreSQL
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
-| **[general.postgresql.pg_client_username](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client username.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_password](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client password.
**Default:** *calculated* |
-| **[general.postgresql.pg_client_database](dictionaries/23_postgresql.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Client database.
**Default:** *calculated* |
-
-
## Requirements services
-- **LocalDNS**
-- Journald
-- **SMTP**
-- **ReverseProxy**
-- **Postgresql**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [SMTP](../README.SMTP.md): Automaticly create a SMTP relay account and authorize sending email.
+- [ReverseProxy](../README.ReverseProxy.md): Automaticly register to service to a reverse proxy server.
+- [Postgresql](../README.Postgresql.md): Automaticly create account and connexion to a PostgreSQL server.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -67,9 +58,9 @@ vaultwarden:
applicationservice: vaultwarden
zones_name:
- localdns
+ - postgresql
- reverseproxy
- smtp
- - postgresql
values:
general.vaultwarden.vaultwarden_domainname: vault.example.net
general.vaultwarden.vaultwarden_admin_email: admin@example.net
@@ -77,17 +68,15 @@ vaultwarden:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [postgresql-client](../postgresql-client/README.md)
-- [relay-mail-client](../relay-mail-client/README.md)
-- [reverse-proxy-client](../reverse-proxy-client/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [postgresql-client](../postgresql-client/README.md): Application service needs interact with a Postgresql server.
+- [relay-mail-client](../relay-mail-client/README.md): Client SMTP.
+- [reverse-proxy-client](../reverse-proxy-client/README.md): Application service needs interact with a a reverse proxy server.
diff --git a/seed/vector/README.md b/seed/vector/README.md
index 46d46c54..dc1e52a3 100644
--- a/seed/vector/README.md
+++ b/seed/vector/README.md
@@ -3,21 +3,25 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# vector
## Synopsis
-Vector, a lightweight, ultra-fast tool for building observability pipelines.
-[Software's website.](https://vector.dev/)
+[Vector, a lightweight, ultra-fast tool for building observability pipelines.](https://vector.dev/)
## Requirements services
-- **LocalDNS**
-- Journald
-- **Loki**
+### Mandatories
-**bold**: provider is mandatory
+- [LocalDNS](../README.LocalDNS.md): DNS forwarder for local domain name.
+- [Loki](../README.Loki.md): Remote loki client.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -26,7 +30,7 @@ Zone names are provided as examples. Think about adapting with the value of prov
```
vector:
applicationservice: vector
- provider_zone: journald
+ provider_zone: vector
zones_name:
- localdns
- loki
@@ -34,23 +38,43 @@ vector:
## Dependances
-- [base-fedora-38](../base-fedora-38/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [journald_remote](../journald_remote/README.md)
+- [base-fedora-38](../base-fedora-38/README.md): Base information of a Fedora 38.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [journald_remote](../journald_remote/README.md): Journald remote.
-## Supplier
+## Useful for services
-[host-systemd-machined](../host-systemd-machined/README.md)
-
-## Provider
-
-[loki](../loki/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [dovecot](../dovecot/README.md): Postfix and Dovecot as mail servers (IMAP and submission).
+- [forgejo](../forgejo/README.md): Forgejo, a community managed lightweight code hosting solution.
+- [gitea](../gitea/README.md): Transitional package for Gitea to Forgejo.
+- [grafana](../grafana/README.md): Grafana is an analytics and interactive visualization web application.
+- [lemonldap](../lemonldap/README.md): LemonLDAP, a Web Single Sign On and Access Management.
+- [loki](../loki/README.md): Loki, a log aggregation platform.
+- [mailman](../mailman/README.md): GNU Mailman, managing electronic mail discussion and e-newsletter lists.
+- [mariadb](../mariadb/README.md): MariaDB, a relational database.
+- [nextcloud](../nextcloud/README.md): Nextcloud, Online collaboration platform.
+- [nginx-reverse-proxy](../nginx-reverse-proxy/README.md): Nginx as reverse proxy.
+- [nginx-static](../nginx-static/README.md): Nginx as static web site.
+- [nsd](../nsd/README.md): NSD, an authoritative DNS name server.
+- [nsd-local](../nsd-local/README.md): NSD, an authoritative DNS name server for local resolution.
+- [odoo](../odoo/README.md): Odoo, an ERP and CRM.
+- [openldap](../openldap/README.md): OpenLDAP, the LDAP server.
+- [peertube](../peertube/README.md): Peertube, a federated (ActivityPub) video streaming platform.
+- [piwigo](../piwigo/README.md): Piwigo, a photo management software.
+- [postfix-relay](../postfix-relay/README.md): Postfix, the mail server, as relay.
+- [postgresql](../postgresql/README.md): Postgresql, a database.
+- [prometheus](../prometheus/README.md): Prometheus, an event monitoring.
+- [redis](../redis/README.md): Redis, an in-memory data structure store.
+- [roundcube](../roundcube/README.md): Roundcube, a webmail.
+- [speedtest-rs](../speedtest-rs/README.md): Speedtest-rs, a very lightweight Speedtest.
+- [unbound](../unbound/README.md): Unbound, a validating, recursive, caching DNS resolver.
+- [vaultwarden](../vaultwarden/README.md): Vaultwarden, a password manager.
+- [vector](../vector/README.md): Vector, a lightweight, ultra-fast tool for building observability pipelines.
+- [znc](../znc/README.md): ZNC, a bouncer IRC.
diff --git a/seed/vector/dictionaries/20_vector.xml b/seed/vector/dictionaries/20_vector.xml
index 4ee6edc5..35ca2586 100644
--- a/seed/vector/dictionaries/20_vector.xml
+++ b/seed/vector/dictionaries/20_vector.xml
@@ -9,11 +9,11 @@
-
-
-
+
+
+
-
+
diff --git a/seed/vector/templates/vector.toml b/seed/vector/templates/vector.toml
index 82a10059..ad8efb77 100644
--- a/seed/vector/templates/vector.toml
+++ b/seed/vector/templates/vector.toml
@@ -25,6 +25,7 @@ data_dir = "/srv/vector"
#format = "syslog"
#interval = 1
{% if general.vector.client_addresses %}
+#from journal
[sources.vector_client]
type = "vector"
{% for address in general.vector.listen_addresses %}
diff --git a/seed/znc/README.md b/seed/znc/README.md
index 71fced75..bd31fe59 100644
--- a/seed/znc/README.md
+++ b/seed/znc/README.md
@@ -3,56 +3,52 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# znc
## Synopsis
-ZNC, a bouncer IRC.
-[Software's website.](https://wiki.znc.in/)
+[ZNC, a bouncer IRC.](https://wiki.znc.in/)
+
+The IRC network bouncer or BNC can detach the client from the actual IRC server, and also from selected channelsp.
## Basic variables
-### Général
+### General
#### IRC Bouncer ZNC
-| Parameter | Comments |
-|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------|
-| **[general.znc.external_domain_name](dictionaries/40_znc.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom de domaine externe de ZNC.
**Example:** irc.example.net |
-| **[general.znc.user_name](dictionaries/40_znc.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Utilisateur IRC et ZNC.
**Example:** jdoe |
-| **[general.znc.user_password](dictionaries/40_znc.xml)**
mandatory
**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 l'utilisateur ZNC.
**Example:** JD0eP@ss |
-| **[general.znc.real_name](dictionaries/40_znc.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom d'utilisateur réel.
**Example:** John Doe |
+| Parameter | Comment |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **[general.znc.external_domain_name](dictionaries/40_znc.xml)**
mandatory
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | External domain name.
**Example:** irc.example.net |
+| **[general.znc.znc_crt_provider](dictionaries/40_znc.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Type of certificate autority signing external certificate.
The certificate can be self-signed (therefore invalid by default for the client) or obtained via the Let's Encrypt service (generally valid for the client).
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
+| **[general.znc.user_name](dictionaries/40_znc.xml)**
mandatory
**Type:** [`unix_user`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | IRC and ZNC username.
**Example:** jdoe |
+| **[general.znc.user_password](dictionaries/40_znc.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | ZNC user password.
**Example:** JD0eP@ss |
+| **[general.znc.real_name](dictionaries/40_znc.xml)**
mandatory
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Real IRC user name.
**Example:** John Doe |
##### Serveurs IRC
This family is a leadership.
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
-| **[general.znc.servers.server_names](dictionaries/40_znc.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Adresse du serveur IRC.
**Example:** irc.oftc.net |
-| **[general.znc.servers.password](dictionaries/40_znc.xml)**
mandatory
**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 l'utilisateur sur le serveur IRC.
**Example:** p@ssw0rd |
-| **[general.znc.servers.channels](dictionaries/40_znc.xml)**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Nom des salons du serveur IRC.
**Example:** example |
-
-## Variables
-
-### Général
-
-#### IRC Bouncer ZNC
-
-| Parameter | Comments |
-|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
-| **[general.znc.znc_crt_provider](dictionaries/40_znc.xml)**
mandatory
**Type:** [`choice`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | Autorité de certification signant le certificat du domaine extérieur.
**Choices:**
- `self-signed` ← default
- `letsencrypt` |
-
+| Parameter | Comments |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------|
+| **[general.znc.servers.server_names](dictionaries/40_znc.xml)**
mandatory, multiple
**Type:** [`domainname`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | IRC domain name.
**Example:** irc.oftc.net |
+| **[general.znc.servers.password](dictionaries/40_znc.xml)**
mandatory
**Type:** [`password`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | IR user passwordC.
**Example:** p@ssw0rd |
+| **[general.znc.servers.channels](dictionaries/40_znc.xml)**
mandatory, multiple
**Type:** [`string`](https://forge.cloud.silique.fr/risotto/rougail/src/branch/main/doc/variable/README.md#le-type-de-la-variable) | IRC channels.
**Example:** example |
## Requirements services
-- **ExternalDNS**
-- Journald
+### Mandatories
-**bold**: provider is mandatory
+- [ExternalDNS](../README.ExternalDNS.md): DNS forwarder for all DNS zones.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Concentrate journal messages on one host.
## Example
@@ -62,7 +58,7 @@ Zone names are provided as examples. Think about adapting with the value of prov
znc:
applicationservice: znc
zones_name:
- - localdns
+ - externaldns
values:
general.znc.external_domain_name: irc.example.net
general.znc.user_name: jdoe
@@ -79,15 +75,13 @@ znc:
## Dependances
-- [base-fedora-36](../base-fedora-36/README.md)
- - [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)
- - [pki-tls](../pki-tls/README.md)
- - [journald](../journald/README.md)
- - [resolved](../resolved/README.md)
-- [dns-external](../dns-external/README.md)
-
-[All applications services for this dataset.](../README.md)
+- [base-fedora-36](../base-fedora-36/README.md): Base information of a Fedora 36.
+ - [base-fedora](../base-fedora/README.md): Base information of a Fedora.
+ - [systemd](../systemd/README.md): Systemd, a system and service manager.
+ - [base-machine](../base-machine/README.md): Base information for a machine.
+ - [base](../base/README.md): Base of all application services.
+ - [dns-local](../dns-local/README.md): DNS client with access to local zones.
+ - [pki-tls](../pki-tls/README.md): Autosign PKI or Let's encrypt support for TLS certificates.
+ - [journald](../journald/README.md): Journald.
+ - [resolved](../resolved/README.md): Resolved.
+- [dns-external](../dns-external/README.md): DNS client with resolution on all zones (especially outside).
diff --git a/seed/znc/applicationservice.yml b/seed/znc/applicationservice.yml
index f400cd65..6901ae95 100644
--- a/seed/znc/applicationservice.yml
+++ b/seed/znc/applicationservice.yml
@@ -1,5 +1,6 @@
format: '0.1'
description: ZNC, a bouncer IRC
+help: The IRC network bouncer or BNC can detach the client from the actual IRC server, and also from selected channels
website: https://wiki.znc.in/
depends:
- base-fedora-36
diff --git a/seed/znc/dictionaries/40_znc.xml b/seed/znc/dictionaries/40_znc.xml
index 33ac2ad0..8bb76112 100644
--- a/seed/znc/dictionaries/40_znc.xml
+++ b/seed/znc/dictionaries/40_znc.xml
@@ -17,22 +17,22 @@
-
-
+
+
self-signed
self-signed
letsencrypt
-
-
-
+
+
+
-
-
-
+
+
+
6697
-
+