diff --git a/seed/README.ExternalDNS.md b/seed/README.ExternalDNS.md
new file mode 100644
index 0000000..eb9b0a9
--- /dev/null
+++ b/seed/README.ExternalDNS.md
@@ -0,0 +1,30 @@
+---
+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
+
+| Name | Comment |
+|-------------------------------------|----------------------------------------------------------|
+| ExternalDNS:authority_zones | Local DNS server can export own authority zones. |
+| ExternalDNS:reverse_authority_zones | Local DNS server can export own authority reverse 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 0000000..f0a4db2
--- /dev/null
+++ b/seed/README.IMAP.md
@@ -0,0 +1,25 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# IMAP
+
+## Synopsis
+
+IMAP client address.
+
+## Variables
+
+| Name | Comment |
+|--------|-----------|
+
+## 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 0000000..ecea27f
--- /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
+
+Remote journald.
+
+## Variables
+
+| Name | Comment |
+|-------------------|-------------------------------------------------------------------------------------------|
+| Journald:service | Log from this service to exclude for *suffix value*. |
+| Journald:function | Function use to compare message (if not defined, exlude same message) for *suffix value*. |
+| Journald:message | Message to exclude for *suffix value*. |
+
+## 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 0000000..e4c1870
--- /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
+
+| Name | Comment |
+|---------------|-------------------------------------|
+| LDAP:family | *suffix value*. |
+| LDAP:dn | LDAP account DN for *suffix value*. |
+| LDAP:password | LDAP passowrd for *suffix value*. |
+| LDAP:base_dn | LDAP base DN for *suffix value*. |
+
+## 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 0000000..9703a56
--- /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
+
+| Name | Comment |
+|---------------|---------------------------------------------------------------------|
+| LMTP:criteria | Domain name allowes to send email with LMTP protocol*suffix value*. |
+
+## 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 0000000..6632f41
--- /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
+
+| Name | Comment |
+|--------------------|-------------------------|
+| LocalDNS:DNSSEC_DS | 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 0000000..3273c19
--- /dev/null
+++ b/seed/README.Loki.md
@@ -0,0 +1,25 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Loki
+
+## Synopsis
+
+Remote loki client.
+
+## Variables
+
+| Name | Comment |
+|--------|-----------|
+
+## 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 0000000..22f3b29
--- /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
+
+| Name | Comment |
+|------------------|-------------------------------------------|
+| MariaDB:database | MariaDB database name for *suffix value*. |
+| MariaDB:username | MariaDB user name for *suffix value*. |
+| MariaDB:password | MariaDB password for *suffix value*. |
+
+## 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 0000000..5653815
--- /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
+
+| Name | Comment |
+|-----------------------------|---------------------------------------------------------------------------------------------------|
+| OAuth2:external_domain | OAuth2 server domain name. |
+| OAuth2:client_id | Remote client id for *suffix value*. |
+| OAuth2:secret | Remote secret for *suffix value*. |
+| OAuth2:name | Remote name for *suffix value*. |
+| OAuth2:description | Remote description for *suffix value*. |
+| OAuth2:category | Remode category for *suffix value*. |
+| OAuth2:login | Remote URL to login for *suffix value*. |
+| OAuth2:external | Remote external for *suffix value*. |
+| OAuth2:family | Remote family for *suffix value*. |
+| OAuth2:logo | Logo for *suffix value*. |
+| OAuth2:token_signature_algo | OAuth2 token signature algorithm for *suffix value*.
**Choices:**
- `HS512`
- `RS256` |
+
+## 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 0000000..a6d8aff
--- /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
+
+| Name | Comment |
+|---------------------|----------------------------------------------|
+| Postgresql:database | Postgresql database name for *suffix value*. |
+| Postgresql:username | Postgresql username for *suffix value*. |
+| Postgresql:password | Postgresql password for *suffix value*. |
+
+## 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 0000000..477fc1d
--- /dev/null
+++ b/seed/README.Prometheus.md
@@ -0,0 +1,21 @@
+---
+gitea: none
+include_toc: true
+---
+
+
+[Return to the list of application services.](README.md)
+# Prometheus
+
+## Synopsis
+
+Automaticly configure Prometheus exporter.
+
+## Variables
+
+| Name | Comment |
+|--------|-----------|
+
+## 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 0000000..369cc1d
--- /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
+
+| Name | Comment |
+|----------------|----------------------------------------------------------------------------------------------------------------------|
+| Redis:index | Redis database index.
Only index 0 is allowed, Redis project discourage to use the server with several database. |
+| Redis:username | Redis user name for *suffix value*. |
+| Redis:password | Redis password for *suffix value*. |
+
+## 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 0000000..59085dd
--- /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
+
+| Name | Comment |
+|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| ReverseProxy:external | External domain name for *suffix value*. |
+| ReverseProxy:location | URI to redirect for *suffix value*.
URL relative (sans le nom de domaine) redirigée pour l'adresse définie dans la variable ci-dessus (exemple "/mail"). |
+| ReverseProxy:url | Internal URL for *suffix value*. |
+| ReverseProxy:websocket | The entry point is a websocket for *suffix value*.
**Default:** [True] |
+| ReverseProxy:max_body_size | Body size max for *suffix value*. |
+| ReverseProxy:http | The website is in HTTP for *suffix value*.
**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 0000000..5b461ad
--- /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
+
+| Name | Comment |
+|---------------|------------------------------------------------|
+| SMTP:username | User account to send email for *suffix value*. |
+| SMTP:password | Password to send email for *suffix value*. |
+
+## 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 0000000..3001f1d
--- /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
+
+| Name | Comment |
+|----------------|---------------|
+| Vector:address | IP addresses. |
+
+## 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 e13feb2..1ac0bd6 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 client address.
+- [Journald](README.Journald.md): Remote journald.
+- [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 661853c..d7004c6 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 7a2aaf0..c885b4c 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 ec2829e..32941e5 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 455c6d1..fb34da0 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 a8164be..6add3e3 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 03ef07a..a5b172f 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 d847226..656eab5 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 1e0f435..0103d01 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 e532760..89b9f61 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 1852ce7..afa89d4 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 b830844..e95b57d 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 031667c..2ccdace 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 56cb808..7f5d073 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 06f3b08..2758fb9 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 78203c7..4cd0191 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 ed2d599..d14fa21 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 |
-## Variables
+| 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` |
-### Général
-
-#### 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
+### General
-#### 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 | 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) | 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): Remote journald.
## 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 3875576..9c6d812 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 6aab827..0884b6c 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 f45092d..55e986b 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 1454e67..121f24e 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 | 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:** / |
#### Forgejo
@@ -38,32 +39,17 @@ Git forge Forgejo.
## 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 | 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. |
#### OAuth2 client
@@ -89,15 +75,18 @@ This family is a leadership.
## 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): Remote journald.
## 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 a6e085a..959628e 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,18 +13,18 @@ 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 | 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:** / |
#### Forgejo
@@ -36,7 +38,7 @@ Git forge Forgejo.
## Variables
-### Général
+### General
#### Forgejo
@@ -54,32 +56,17 @@ Git forge Forgejo.
## 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 | 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. |
#### OAuth2 client
@@ -105,15 +92,18 @@ This family is a leadership.
## 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): Remote journald.
## Example
@@ -124,11 +114,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 +126,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 46cbcb0..74d5f73 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 | 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:** / |
#### OAuth2 client
@@ -37,25 +38,17 @@ This family is a leadership.
## 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 | 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. |
#### OAuth2 client
@@ -79,14 +72,17 @@ This family is a leadership.
## 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): Remote journald.
## 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 8799fc5..a48d2c2 100644
--- a/seed/host-systemd-machined/README.md
+++ b/seed/host-systemd-machined/README.md
@@ -3,17 +3,18 @@ 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
@@ -34,7 +35,7 @@ This family is a leadership.
## Variables
-### Général
+### General
| Parameter | Comments |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------|
@@ -46,22 +47,22 @@ This family is a leadership.
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` |
+
+## Variables for expert
+
+### General
+
+#### base
+
+| Parameter | Comments |
+|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------|
+| **[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 |
+
## 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 b6fbbe8..39e9bef 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 5fdb810..708ac6e 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 469d5cb..2039558 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 8295794..8b11b2d 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 00a1d5e..3d5e862 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 5edfcb1..c035cf1 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 b9bab68..d68657e 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 a43a205..14f5987 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 23a8a20..700b63b 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
@@ -13,19 +15,15 @@ Application service needs interact with a LDAP server.
## Variables for expert
-### Général
+### General
-#### 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 a4d4dda..79a2c29 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 343873e..44c3e3e 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 | 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:** / |
#### LemonLDAP
@@ -37,38 +38,32 @@ Configuration de la solution d'authentification unique LemonLDAP::NG.
## Variables for expert
-### Général
+### General
-#### 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* |
+| 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) | Restrict service configuration for a LDAP family.
"all" for all families.
**Default:** all |
#### 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 |
#### 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. |
#### LemonLDAP
@@ -80,13 +75,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): Remote journald.
## Example
@@ -109,23 +107,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 9a1a382..b9b9285 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 41689fa..8f80778 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): Remote journald.
## 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 5b5fb9e..b3b6e1d 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 beb4b9f..88917dc 100644
--- a/seed/mailman/README.md
+++ b/seed/mailman/README.md
@@ -3,28 +3,29 @@ 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 | 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:** / |
#### Gestionnaire de liste
@@ -39,41 +40,31 @@ 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 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 |
#### 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 | 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. |
#### OAuth2 client
@@ -99,15 +90,17 @@ This family is a leadership.
## 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): Remote journald.
## Example
@@ -118,11 +111,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 +125,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 dca610f..0eb02b2 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 6d3f721..8314404 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 dbf9232..6e57c9e 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): Remote journald.
## 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 e5a3eeb..bc109f7 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 d72cd4e..2c03846 100644
--- a/seed/nextcloud/README.md
+++ b/seed/nextcloud/README.md
@@ -3,103 +3,80 @@ 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 | 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:** / |
#### 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 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/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 |
+| 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 |
#### 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 |
-#### 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. |
#### 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 | 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. |
#### OAuth2 client
@@ -125,16 +102,19 @@ This family is a leadership.
## 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): Remote journald.
## Example
@@ -146,11 +126,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 +139,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 993a124..1a82fdc 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 0ef9bd8..fb5ed8a 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 15c4ba2..e270e78 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 042c4fb..15fdfd5 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 996375c..c047fcf 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 a220c07..30fcba8 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): Remote journald.
## 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 84fd320..b55a580 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 f63e337..9c72f36 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 b9a51d3..a490543 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 878c578..f506abf 100644
--- a/seed/nginx-static/README.md
+++ b/seed/nginx-static/README.md
@@ -3,37 +3,36 @@ 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 |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|
| **[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 |
@@ -42,34 +41,35 @@ Paramétrage global de NGINX.
## 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 |
#### 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): Remote journald.
## 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 54ea59c..8cb53f2 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): Remote journald.
## 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 4ee4230..071af5e 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 526650a..f067397 100644
--- a/seed/nsd/README.md
+++ b/seed/nsd/README.md
@@ -3,17 +3,18 @@ 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
@@ -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): Remote journald.
## 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 22d8fa0..b6968b3 100644
--- a/seed/oauth2-client/README.md
+++ b/seed/oauth2-client/README.md
@@ -3,6 +3,8 @@ gitea: none
include_toc: true
---
+
+[Return to the list of application services.](../README.md)
# oauth2-client
## Synopsis
@@ -13,7 +15,7 @@ Application service needs interact with a Oauth2 server.
## Variables for expert
-### Général
+### General
#### OAuth2 client
@@ -46,9 +48,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 4945431..e829a15 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 4b52c6e..4025dd6 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 | 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:** / |
#### Odoo
@@ -48,46 +49,32 @@ This family is a leadership.
## Variables for expert
-### Général
+### General
-#### 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. |
#### 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 |
#### 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 | 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. |
#### OAuth2 client
@@ -117,15 +104,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): Remote journald.
## Example
@@ -137,10 +127,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 +149,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 f190b05..b513484 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
@@ -51,17 +51,17 @@ 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
@@ -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): Remote journald.
## 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 c1972f8..dd98537 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 b1605d4..05ce5b9 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 | 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/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,7 +35,7 @@ This family is a leadership.
## Variables
-### Général
+### General
#### peertube
@@ -45,41 +46,24 @@ This family is a leadership.
## 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 |
#### 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 | 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) | The maximum allowed size of the client request body.
**Default:** 12G |
#### OAuth2 client
@@ -105,15 +89,18 @@ This family is a leadership.
## 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): Remote journald.
## 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 1670268..dfb7d3e 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 99e6d89..953cd20 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 026882e..ed80b0f 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 3657cbb..8e670be 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 | 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:** / |
#### Piwigo
@@ -43,7 +44,7 @@ This family is a leadership.
## Variables
-### Général
+### General
#### Piwigo
@@ -55,63 +56,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 | 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 |
#### 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) | 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 |
-| 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 | 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. |
#### 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 | 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. |
#### OAuth2 client
@@ -137,16 +120,19 @@ This family is a leadership.
## 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): Remote journald.
## 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 291e377..52bef95 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 1686493..660897d 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 d2f3e87..ba415f5 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 ebd48a4..acb5b2e 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): Remote journald.
## 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 2a3d1ce..7e0789d 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 e636715..a6abec8 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 54ca4a3..d4c60be 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 cdb79b1..db56626 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 d70417a..11d9604 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 c1a841e..fc23e93 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): Remote journald.
## 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 ff655c4..8c38232 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 7331607..84b3163 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 4be5dc9..039eea5 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 a32b0a6..48d9b4d 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 b0275c8..4abffe6 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 8b58468..58b48b1 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 eccb458..225399c 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 8832d3e..0213563 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): Remote journald.
## 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 007576c..88af7de 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 2cf2eca..634f41c 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 888424f..8bc2d79 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 eca8416..e0f2c4f 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 2cbcf24..014d08e 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 eec0fc5..6a0c3cd 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 f0ca94f..e31c17e 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 c77c958..9673be0 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 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 cee5ce4..afc1746 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 78d3d2c..fe9c0b5 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,7 @@ This family is a leadership.
## Variables
-### Général
+### General
#### Interface web de consultation des courriels Roundcube
@@ -42,60 +43,27 @@ 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 | 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 |
#### 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* |
+| 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 |
#### OAuth2 client
@@ -121,16 +89,19 @@ Paramétrage global de NGINX.
## 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 client address.
+
+### Optionals
+
+- [Journald](../README.Journald.md): Remote journald.
## 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 a04828f..8f33d2b 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 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): Remote journald.
## 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 3529d6c..fb458ce 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 1231721..f1f0f04 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 e3afeb2..6670dc6 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 9153704..82154bc 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): Remote journald.
## 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 342789a..e58c22d 100644
--- a/seed/unbound/dictionaries/20_unbound.xml
+++ b/seed/unbound/dictionaries/20_unbound.xml
@@ -17,7 +17,7 @@
-
+
udp:53
@@ -26,9 +26,9 @@
-
-
-
+
+
+
diff --git a/seed/vaultwarden/README.md b/seed/vaultwarden/README.md
index 025b197..fc4bb7e 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): Remote journald.
## 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 46d46c5..b126fd7 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): Remote journald.
## 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 4ee6edc..d6416c3 100644
--- a/seed/vector/dictionaries/20_vector.xml
+++ b/seed/vector/dictionaries/20_vector.xml
@@ -9,11 +9,11 @@
-
-
-
+
+
+
-
+
diff --git a/seed/znc/README.md b/seed/znc/README.md
index 71fced7..cbe64a5 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 | 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) | 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): Remote journald.
## 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 f400cd6..6901ae9 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 33ac2ad..8bb7611 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
-
+