diff --git a/pages/02.administer/10.install/install.md b/pages/02.administer/10.install/install.md index 6af55992..e9555a77 100644 --- a/pages/02.administer/10.install/install.md +++ b/pages/02.administer/10.install/install.md @@ -665,7 +665,7 @@ In an internet browser, type **{% if internetcube %}`https://internetcube.local` !!! If this doesn't work, you can [look for the the local IP address of your server](/finding_the_local_ip). The address typically looks like `192.168.x.y`, and you should therefore type `https://192.168.x.y` in your browser's address bar. {% else %} -You can perform the initial configuration with the web interface by typing in the adress bar of your web browser **the public IP address of your server**. Typically, your VPS provider should have provided you with the IP of the server. +You can perform the initial configuration with the web interface by typing in the address bar of your web browser **the public IP address of your server**. Typically, your VPS provider should have provided you with the IP of the server. {% endif %} ! During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. {% if not wsl %}You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). {% endif %} For now, you should add a security exception to accept the current certificate. (Though, PLEASE, do not take the habit of blindly accepting this kind of security alert!) diff --git a/pages/02.administer/15.admin_guide/20.users/users.md b/pages/02.administer/15.admin_guide/20.users/users.md index 8499b90c..0377b8c2 100644 --- a/pages/02.administer/15.admin_guide/20.users/users.md +++ b/pages/02.administer/15.admin_guide/20.users/users.md @@ -13,7 +13,7 @@ routes: Users are human being who have access to applications and other services on your server. The administrator can add and manage users through the web administration (in the User category) or through the command line (see `yunohost user --help`). After that, users obtain a personal email address (chosen by the admin), an XMPP account, and can log in the user portal to access applications they have permissions over and configure other parameters. -The first user created also automatically gets email aliases `root@main.domain.tld` and `admin@main.domain.tld`, such that mail sent to these adresses will end up in the first user's mailbox. +The first user created also automatically gets email aliases `root@main.domain.tld` and `admin@main.domain.tld`, such that mail sent to these addresses will end up in the first user's mailbox. ! You should be careful about who you give your server access to. In terms of security, this largely increase the attack surface for someone who wants to mess with the server one way or another. diff --git a/pages/02.administer/15.admin_guide/25.domains/domains.md b/pages/02.administer/15.admin_guide/25.domains/domains.md index d1914026..359f4b5d 100644 --- a/pages/02.administer/15.admin_guide/25.domains/domains.md +++ b/pages/02.administer/15.admin_guide/25.domains/domains.md @@ -10,7 +10,7 @@ shortcode-ui: tabs: lite --- -DNS (Domain Name System) is a system that allows computers from around the world to translate human-readable domain names (such as `yolo.com`) to machine-understandable adresses called IP addresses (such as `11.22.33.44`). For this translation (and other features) to work, you must carefully configure DNS records. +DNS (Domain Name System) is a system that allows computers from around the world to translate human-readable domain names (such as `yolo.com`) to machine-understandable addresses called IP addresses (such as `11.22.33.44`). For this translation (and other features) to work, you must carefully configure DNS records. YunoHost allows you to manage and serve several domains on the same server with the same public ip. For instance, you can host a blog and Nextcloud on a first domain `yolo.com`, and a web mail client on a second domain `swag.nohost.me`. Each domain is automatically configured to handle web services, mail services and XMPP services. diff --git a/pages/02.administer/15.admin_guide/45.emails/email.md b/pages/02.administer/15.admin_guide/45.emails/email.md index d1a3ea34..5a9bea26 100644 --- a/pages/02.administer/15.admin_guide/45.emails/email.md +++ b/pages/02.administer/15.admin_guide/45.emails/email.md @@ -29,7 +29,7 @@ Desktop and mobile clients have the advantage of copying your emails to the devi ## Configuring email aliases and auto-forwards -Mail aliases and forwards can be configured for each users. For instance, the first user created on the server automatically has an alias `root@the.domain.tld` configured - meaning that an email sent to this adress will end in the inbox of the first user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just wants to receive emails from the server on, say, his/her gmail address. +Mail aliases and forwards can be configured for each users. For instance, the first user created on the server automatically has an alias `root@the.domain.tld` configured - meaning that an email sent to this address will end in the inbox of the first user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just wants to receive emails from the server on, say, his/her gmail address. Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@the.domain.tld` will automatically land in the `booking` dir (lowercase) of John Doe's mailbox or in John Doe's inbox if `booking` directory doesn't exist . It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website. @@ -37,12 +37,12 @@ Groups also can use alias features, by default the group `admins` have `root@ Configuration -> feed tab -> OPML section -> You can read your feeds on Android using ttrss-reader application: **[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)** To use it, you need to go to Actions -> Configuration, in Tiny Tiny RSS web interface and select "Activate API". -Then, in your android ttrss-reader, fill the Tiny Tiny RSS server adress: https://yourdomain.org/ttrss, username, password (no need to use HTTP authentification). +Then, in your android ttrss-reader, fill the Tiny Tiny RSS server address: https://yourdomain.org/ttrss, username, password (no need to use HTTP authentication). **Note**: you may need to uninstall and reinstall the Tiny Tiny RSS application through the YunoHost admin panel in order to be able to connect. diff --git a/pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md b/pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md index 680cdb3e..bdab796e 100644 --- a/pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md +++ b/pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md @@ -7,7 +7,7 @@ routes: default: '/packaging_apps_helpers' --- -Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/doc/generate_helper_doc.py) on 14/06/2023 (YunoHost version 11.1.21.4) +Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/doc/generate_helper_doc.py) on 19/07/2023 (YunoHost version 11.2.2) ## APPS @@ -25,7 +25,7 @@ Requires YunoHost version *.*.* or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apps#L9) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apps#L9) [/details] ---------------- @@ -41,7 +41,7 @@ Requires YunoHost version *.*.* or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apps#L65) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apps#L65) [/details] ---------------- @@ -66,11 +66,11 @@ Requires YunoHost version *.*.* or higher. Requires YunoHost version 11.0.* or higher, and that the app relies on packaging v2 or higher. The spawned shell will have environment variables loaded and environment files sourced from the app's service configuration file (defaults to $app.service, overridable by the packager with `service` setting). -If the app relies on a specific PHP version, then `php` will be aliased that version. +If the app relies on a specific PHP version, then `php` will be aliased that version. The PHP command will also be appended with the `phpflags` settings. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apps#L128) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apps#L128) [/details] ---------------- @@ -94,7 +94,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L53) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L53) [/details] ---------------- @@ -115,7 +115,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L75) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L75) [/details] ---------------- @@ -129,7 +129,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L107) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L107) [/details] ---------------- @@ -146,7 +146,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L117) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L117) [/details] ---------------- @@ -163,7 +163,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L128) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L128) [/details] ---------------- @@ -180,7 +180,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L138) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L138) [/details] ---------------- @@ -197,7 +197,7 @@ Requires YunoHost version 2.7.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L148) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L148) [/details] ---------------- @@ -219,7 +219,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L225) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L225) [/details] ---------------- @@ -236,7 +236,7 @@ Requires YunoHost version 3.8.1 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L338) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L338) [/details] ---------------- @@ -252,7 +252,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L357) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L357) [/details] ---------------- @@ -272,7 +272,7 @@ Requires YunoHost version 3.8.1 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/apt#L391) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/apt#L391) [/details] ---------------- @@ -345,7 +345,7 @@ Requires YunoHost version 3.5.0 or higher for the argument `--not_mandatory` -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L64) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L64) [/details] ---------------- @@ -359,7 +359,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L179) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L179) [/details] ---------------- @@ -404,7 +404,7 @@ Requires YunoHost version 3.5.0 or higher for the argument --not_mandatory -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L238) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L238) [/details] ---------------- @@ -423,7 +423,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L306) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L306) [/details] ---------------- @@ -445,7 +445,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L357) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L357) [/details] ---------------- @@ -464,7 +464,7 @@ Requires YunoHost version 3.3.1 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L397) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L397) [/details] ---------------- @@ -487,7 +487,7 @@ Requires YunoHost version 2.7.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L432) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L432) [/details] ---------------- @@ -510,7 +510,7 @@ Requires YunoHost version 2.7.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/backup#L480) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/backup#L480) [/details] ---------------- @@ -587,7 +587,7 @@ Requires YunoHost version 4.1.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/fail2ban#L64) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/fail2ban#L64) [/details] ---------------- @@ -601,7 +601,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/fail2ban#L119) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/fail2ban#L119) [/details] ---------------- @@ -629,7 +629,7 @@ Requires YunoHost version 3.8.1 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/hardware#L13) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/hardware#L13) [/details] ---------------- @@ -652,7 +652,7 @@ Requires YunoHost version 3.8.1 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/hardware#L75) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/hardware#L75) [/details] ---------------- @@ -673,7 +673,7 @@ Requires YunoHost version 2.4.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L10) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L10) [/details] ---------------- @@ -690,7 +690,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L30) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L30) [/details] ---------------- @@ -707,7 +707,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L56) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L56) [/details] ---------------- @@ -724,7 +724,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L73) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L73) [/details] ---------------- @@ -743,7 +743,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L92) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L92) [/details] ---------------- @@ -762,7 +762,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L113) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L113) [/details] ---------------- @@ -781,7 +781,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L134) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L134) [/details] ---------------- @@ -800,7 +800,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L155) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L155) [/details] ---------------- @@ -819,7 +819,7 @@ Requires YunoHost version 3.2.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L176) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L176) [/details] ---------------- @@ -839,7 +839,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L237) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L237) [/details] ---------------- @@ -854,7 +854,7 @@ Requires YunoHost version 3.6.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logging#L325) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logging#L325) [/details] ---------------- @@ -883,7 +883,7 @@ Requires YunoHost version 3.2.0 or higher for the argument `--specific_user` -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logrotate#L18) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logrotate#L18) [/details] ---------------- @@ -897,7 +897,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/logrotate#L109) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/logrotate#L109) [/details] ---------------- @@ -914,7 +914,7 @@ Requires YunoHost version 4.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/multimedia#L11) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/multimedia#L11) [/details] ---------------- @@ -934,7 +934,7 @@ Requires YunoHost version 4.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/multimedia#L64) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/multimedia#L64) [/details] ---------------- @@ -951,7 +951,7 @@ Requires YunoHost version 4.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/multimedia#L93) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/multimedia#L93) [/details] ---------------- @@ -984,7 +984,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L15) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L15) [/details] ---------------- @@ -1002,7 +1002,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L36) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L36) [/details] ---------------- @@ -1020,7 +1020,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L60) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L60) [/details] ---------------- @@ -1041,7 +1041,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L128) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L128) [/details] ---------------- @@ -1060,7 +1060,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L160) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L160) [/details] ---------------- @@ -1082,7 +1082,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L198) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L198) [/details] ---------------- @@ -1100,7 +1100,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/mysql#L224) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/mysql#L224) [/details] ---------------- @@ -1124,7 +1124,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/network#L12) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/network#L12) [/details] ---------------- @@ -1145,7 +1145,7 @@ Requires YunoHost version 3.8.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/network#L36) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/network#L36) [/details] ---------------- @@ -1166,7 +1166,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/network#L99) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/network#L99) [/details] ---------------- @@ -1187,7 +1187,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/network#L119) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/network#L119) [/details] ---------------- @@ -1215,7 +1215,7 @@ Requires YunoHost version 4.1.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/nginx#L19) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/nginx#L19) [/details] ---------------- @@ -1229,7 +1229,7 @@ Requires YunoHost version 2.7.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/nginx#L41) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/nginx#L41) [/details] ---------------- @@ -1243,7 +1243,7 @@ Requires YunoHost version 11.1.9 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/nginx#L52) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/nginx#L52) [/details] ---------------- @@ -1297,7 +1297,7 @@ Requires YunoHost version 2.7.12 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/nodejs#L52) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/nodejs#L52) [/details] ---------------- @@ -1321,7 +1321,7 @@ Requires YunoHost version 2.7.12 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/nodejs#L92) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/nodejs#L92) [/details] ---------------- @@ -1339,7 +1339,7 @@ Requires YunoHost version 2.7.12 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/nodejs#L165) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/nodejs#L165) [/details] ---------------- @@ -1412,7 +1412,7 @@ Requires YunoHost version 3.7.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L66) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L66) [/details] ---------------- @@ -1431,7 +1431,7 @@ Requires YunoHost version 3.7.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L152) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L152) [/details] ---------------- @@ -1449,7 +1449,7 @@ Requires YunoHost version 3.7.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L169) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L169) [/details] ---------------- @@ -1472,7 +1472,7 @@ Requires YunoHost version 3.7.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L192) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L192) [/details] ---------------- @@ -1495,7 +1495,7 @@ Requires YunoHost version 3.7.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L260) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L260) [/details] ---------------- @@ -1516,7 +1516,7 @@ Requires YunoHost version 3.7.1 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L329) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L329) [/details] ---------------- @@ -1531,7 +1531,7 @@ Requires YunoHost version 4.1.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L359) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L359) [/details] ---------------- @@ -1542,7 +1542,7 @@ Requires YunoHost version 4.1.2 or higher. **Example**: `if ynh_legacy_permissions_exists then ynh_legacy_permissions_delete_all # You can recreate the required permissions here with ynh_permission_create fi Requires YunoHost version 4.1.2 or higher.` -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/permission#L379) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/permission#L379) [/details] ---------------- @@ -1552,28 +1552,44 @@ Requires YunoHost version 4.1.2 or higher. #### ynh_add_fpm_config [details summary="Create a dedicated PHP-FPM config" class="helper-card-subtitle text-muted"] -**Usage**: `1: ynh_add_fpm_config [--phpversion=7.X] [--use_template] [--package=packages] [--dedicated_service] -2: ynh_add_fpm_config [--phpversion=7.X] --usage=usage --footprint=footprint [--package=packages] [--dedicated_service] +**Usage**: `ynh_add_fpm_config` + +**Details**:
+Case 1 (recommended) : your provided a snippet conf/extra_php-fpm.conf + +The actual PHP configuration will be automatically generated, +and your extra_php-fpm.conf will be appended (typically contains PHP upload limits) + +The resulting configuration will be deployed to the appropriate place, /etc/php/$phpversion/fpm/pool.d/$app.conf + +Performance-related options in the PHP conf, such as : +pm.max_children, pm.start_servers, pm.min_spare_servers pm.max_spare_servers +are computed from two parameters called "usage" and "footprint" which can be set to low/medium/high. (cf details below) + +If you wish to tweak those, please initialize the settings `fpm_usage` and `fpm_footprint` +*prior* to calling this helper. Otherwise, "low" will be used as a default for both values. + +Otherwise, if you want the user to have control over these, we encourage to create a config panel +(which should ultimately be standardized by the core ...) + +Case 2 (deprecate) : you provided an entire conf/php-fpm.conf + +The configuration will be hydrated, replacing __FOOBAR__ placeholders with $foobar values, etc. + +The resulting configuration will be deployed to the appropriate place, /etc/php/$phpversion/fpm/pool.d/$app.conf + +---------------------- + +fpm_footprint: Memory footprint of the service (low/medium/high). low - Less than 20 MB of RAM by pool. medium - Between 20 MB and 40 MB of RAM by pool. high - More than 40 MB of RAM by pool. -Or specify exactly the footprint, the load of the service as MB by pool instead of having a standard value. -To have this value, use the following command and stress the service. -watch -n0.5 ps -o user,cmd,%cpu,rss -u APP` +N - Or you can specify a quantitative footprint as MB by pool (use watch -n0.5 ps -o user,cmd,%cpu,rss -u APP) -**Arguments**: -- `-v`, `--phpversion=`: Version of PHP to use. -- `-t`, `--use_template`: Use this helper in template mode. -- `-p`, `--package=`: Additionnal PHP packages to install -- `-d`, `--dedicated_service`: Use a dedicated PHP-FPM service instead of the common one. -- `-v`, `--phpversion=`: Version of PHP to use. -- `-f`, `--footprint=`: Memory footprint of the service (low/medium/high). -- `-u`, `--usage=`: Expected usage of the service (low/medium/high). -- `-p`, `--package=`: Additionnal PHP packages to install for a specific version of PHP -- `-d`, `--dedicated_service`: Use a dedicated PHP-FPM service instead of the common one. - -**Details**:
------------------------------------------------------------------------------ +fpm_usage: Expected usage of the service (low/medium/high). +low - Personal usage, behind the SSO. +medium - Low usage, few people or/and publicly accessible. +high - High usage, frequently visited website. The footprint of the service will be used to defined the maximum footprint we can allow, which is half the maximum RAM. So it will be used to defined 'pm.max_children' @@ -1600,7 +1616,7 @@ Requires YunoHost version 4.1.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/php#L59) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/php#L70) [/details] ---------------- @@ -1614,7 +1630,7 @@ Requires YunoHost version 2.7.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/php#L257) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/php#L281) [/details] ---------------- @@ -1633,7 +1649,7 @@ Requires YunoHost version 4.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/php#L490) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/php#L514) [/details] ---------------- @@ -1653,7 +1669,7 @@ Requires YunoHost version 4.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/php#L522) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/php#L546) [/details] ---------------- @@ -1686,7 +1702,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L18) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L18) [/details] ---------------- @@ -1704,7 +1720,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L39) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L39) [/details] ---------------- @@ -1722,7 +1738,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L64) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L64) [/details] ---------------- @@ -1743,7 +1759,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L135) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L135) [/details] ---------------- @@ -1761,7 +1777,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L168) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L168) [/details] ---------------- @@ -1779,7 +1795,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L190) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L190) [/details] ---------------- @@ -1801,7 +1817,7 @@ Requires YunoHost version 2.7.13 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L234) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L234) [/details] ---------------- @@ -1819,7 +1835,7 @@ Requires YunoHost version 2.7.13 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/postgresql#L265) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/postgresql#L265) [/details] ---------------- @@ -1840,7 +1856,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/setting#L10) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/setting#L10) [/details] ---------------- @@ -1859,7 +1875,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/setting#L36) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/setting#L36) [/details] ---------------- @@ -1877,7 +1893,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/setting#L62) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/setting#L62) [/details] ---------------- @@ -1897,7 +1913,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/setting#L123) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/setting#L123) [/details] ---------------- @@ -1918,7 +1934,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/setting#L145) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/setting#L145) [/details] ---------------- @@ -1943,7 +1959,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/string#L13) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/string#L13) [/details] ---------------- @@ -1965,7 +1981,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/string#L40) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/string#L40) [/details] ---------------- @@ -1987,7 +2003,7 @@ Requires YunoHost version 2.7.7 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/string#L71) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/string#L71) [/details] ---------------- @@ -2010,7 +2026,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/string#L103) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/string#L103) [/details] ---------------- @@ -2036,7 +2052,7 @@ Requires YunoHost version 4.1.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/systemd#L15) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/systemd#L15) [/details] ---------------- @@ -2053,7 +2069,7 @@ Requires YunoHost version 2.7.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/systemd#L38) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/systemd#L38) [/details] ---------------- @@ -2075,7 +2091,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/systemd#L67) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/systemd#L67) [/details] ---------------- @@ -2099,7 +2115,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L12) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L12) [/details] ---------------- @@ -2121,7 +2137,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L33) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L33) [/details] ---------------- @@ -2139,7 +2155,7 @@ Requires YunoHost version 2.4.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L53) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L53) [/details] ---------------- @@ -2158,7 +2174,7 @@ Requires YunoHost version 2.2.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L64) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L64) [/details] ---------------- @@ -2177,7 +2193,7 @@ Requires YunoHost version 3.5.0.2 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L82) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L82) [/details] ---------------- @@ -2206,7 +2222,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L111) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L111) [/details] ---------------- @@ -2223,7 +2239,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L153) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L153) [/details] ---------------- @@ -2237,7 +2253,7 @@ Requires YunoHost version 4.1.7 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/user#L179) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/user#L179) [/details] ---------------- @@ -2258,7 +2274,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L61) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L61) [/details] ---------------- @@ -2350,7 +2366,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L154) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L154) [/details] ---------------- @@ -2376,7 +2392,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L397) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L397) [/details] ---------------- @@ -2434,7 +2450,7 @@ Requires YunoHost version 4.1.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L481) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L481) [/details] ---------------- @@ -2478,7 +2494,7 @@ Requires YunoHost version 4.3 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L635) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L635) [/details] ---------------- @@ -2497,7 +2513,7 @@ Requires YunoHost version 4.3 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L712) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L712) [/details] ---------------- @@ -2513,7 +2529,7 @@ Requires YunoHost version 2.7.12 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L827) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L827) [/details] ---------------- @@ -2530,7 +2546,7 @@ Requires YunoHost version 2.6.4 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L858) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L858) [/details] ---------------- @@ -2550,7 +2566,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L892) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L892) [/details] ---------------- @@ -2575,7 +2591,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L935) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L935) [/details] ---------------- @@ -2598,7 +2614,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L964) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L964) [/details] ---------------- @@ -2621,7 +2637,7 @@ Requires YunoHost version 3.5.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L989) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L989) [/details] ---------------- @@ -2653,7 +2669,7 @@ Requires YunoHost version 3.8.0 or higher. -[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/helpers/utils#L1019) +[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/helpers/utils#L1019) [/details] ---------------- diff --git a/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md b/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md index 86a7e6e3..445a2597 100644 --- a/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md +++ b/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md @@ -7,7 +7,7 @@ routes: default: '/packaging_apps_resources' --- -Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/19eb48b6e73267685e1417122ac47908c1cf2472/doc/generate_resource_doc.py) on 14/06/2023 (YunoHost version 11.1.21.4) +Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/53bc30b9fb1ca698b971ae10e579abce605b56b0/doc/generate_resource_doc.py) on 19/07/2023 (YunoHost version 11.2.2) ---------------- @@ -19,16 +19,16 @@ Create a virtual package in apt, depending on the list of specified packages tha ##### Example ```toml [resources.apt] -packages = "nyancat, lolcat, sl" +packages = ["nyancat", "lolcat", "sl"] # (this part is optional and corresponds to the legacy ynh_install_extra_app_dependencies helper) extras.yarn.repo = "deb https://dl.yarnpkg.com/debian/ stable main" extras.yarn.key = "https://dl.yarnpkg.com/debian/pubkey.gpg" -extras.yarn.packages = "yarn" +extras.yarn.packages = ["yarn"] ``` ##### Properties -- `packages`: Comma-separated list of packages to be installed via `apt` +- `packages`: List of packages to be installed via `apt` - `packages_from_raw_bash`: A multi-line bash snippet (using triple quotes as open/close) which should echo additional packages to be installed. Meant to be used for packages to be conditionally installed depending on architecture, debian version, install questions, or other logic. - `extras`: A dict of (repo, key, packages) corresponding to "extra" repositories to fetch dependencies from @@ -225,11 +225,11 @@ Various options are available to accomodate the behavior according to the asset ```toml [resources.sources] -[resources.sources.main] -url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.tar.gz" -sha256 = "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b" + [resources.sources.main] + url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.tar.gz" + sha256 = "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b" -autoupdate.strategy = "latest_github_tag" + autoupdate.strategy = "latest_github_tag" ``` Or more complex examples with several element, including one with asset that depends on the arch @@ -237,25 +237,25 @@ Or more complex examples with several element, including one with asset that dep ```toml [resources.sources] -[resources.sources.main] -in_subdir = false -amd64.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.amd64.tar.gz" -amd64.sha256 = "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b" -i386.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.386.tar.gz" -i386.sha256 = "53c234e5e8472b6ac51c1ae1cab3fe06fad053beb8ebfd8977b010655bfdd3c3" -armhf.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.arm.tar.gz" -armhf.sha256 = "4355a46b19d348dc2f57c046f8ef63d4538ebb936000f3c9ee954a27460dd865" + [resources.sources.main] + in_subdir = false + amd64.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.amd64.tar.gz" + amd64.sha256 = "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b" + i386.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.386.tar.gz" + i386.sha256 = "53c234e5e8472b6ac51c1ae1cab3fe06fad053beb8ebfd8977b010655bfdd3c3" + armhf.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.arm.tar.gz" + armhf.sha256 = "4355a46b19d348dc2f57c046f8ef63d4538ebb936000f3c9ee954a27460dd865" -autoupdate.strategy = "latest_github_release" -autoupdate.asset.amd64 = ".*\.amd64.tar.gz" -autoupdate.asset.i386 = ".*\.386.tar.gz" -autoupdate.asset.armhf = ".*\.arm.tar.gz" + autoupdate.strategy = "latest_github_release" + autoupdate.asset.amd64 = ".*\.amd64.tar.gz" + autoupdate.asset.i386 = ".*\.386.tar.gz" + autoupdate.asset.armhf = ".*\.arm.tar.gz" -[resources.sources.zblerg] -url = "https://zblerg.com/download/zblerg" -sha256 = "1121cfccd5913f0a63fec40a6ffd44ea64f9dc135c66634ba001d10bcf4302a2" -format = "script" -rename = "zblerg.sh" + [resources.sources.zblerg] + url = "https://zblerg.com/download/zblerg" + sha256 = "1121cfccd5913f0a63fec40a6ffd44ea64f9dc135c66634ba001d10bcf4302a2" + format = "script" + rename = "zblerg.sh" ``` @@ -263,14 +263,14 @@ rename = "zblerg.sh" - `prefetch` : `true` (default) or `false`, wether or not to pre-fetch this asset during the provisioning phase of the resource. If several arch-dependent url are provided, YunoHost will only prefetch the one for the current system architecture. - `url` : the asset's URL -- If the asset's URL depend on the architecture, you may instead provide `amd64.url`, `i386.url`, `armhf.url` and `arm64.url` (depending on what architectures are supported), using the same `dpkg --print-architecture` nomenclature as for the supported architecture key in the manifest + - If the asset's URL depend on the architecture, you may instead provide `amd64.url`, `i386.url`, `armhf.url` and `arm64.url` (depending on what architectures are supported), using the same `dpkg --print-architecture` nomenclature as for the supported architecture key in the manifest - `sha256` : the asset's sha256sum. This is used both as an integrity check, and as a layer of security to protect against malicious actors which could have injected malicious code inside the asset... -- Same as `url` : if the asset's URL depend on the architecture, you may instead provide `amd64.sha256`, `i386.sha256`, ... + - Same as `url` : if the asset's URL depend on the architecture, you may instead provide `amd64.sha256`, `i386.sha256`, ... - `format` : The "format" of the asset. It is typically automatically guessed from the extension of the URL (or the mention of "tarball", "zipball" in the URL), but can be set explicitly: -- `tar.gz`, `tar.xz`, `tar.bz2` : will use `tar` to extract the archive -- `zip` : will use `unzip` to extract the archive -- `docker` : useful to extract files from an already-built docker image (instead of rebuilding them locally). Will use `docker-image-extract` -- `whatever`: whatever arbitrary value, not really meaningful except to imply that the file won't be extracted (eg because it's a .deb to be manually installed with dpkg/apt, or a script, or ...) + - `tar.gz`, `tar.xz`, `tar.bz2` : will use `tar` to extract the archive + - `zip` : will use `unzip` to extract the archive + - `docker` : useful to extract files from an already-built docker image (instead of rebuilding them locally). Will use `docker-image-extract` + - `whatever`: whatever arbitrary value, not really meaningful except to imply that the file won't be extracted (eg because it's a .deb to be manually installed with dpkg/apt, or a script, or ...) - `in_subdir`: `true` (default) or `false`, depending on if there's an intermediate subdir in the archive before accessing the actual files. Can also be `N` (an integer) to handle special cases where there's `N` level of subdir to get rid of to actually access the files - `extract` : `true` or `false`. Defaults to `true` for archives such as `zip`, `tar.gz`, `tar.bz2`, ... Or defaults to `false` when `format` is not something that should be extracted. When `extract = false`, the file will only be `mv`ed to the location, possibly renamed using the `rename` value - `rename`: some string like `whatever_your_want`, to be used for convenience when `extract` is `false` and the default name of the file is not practical @@ -287,8 +287,8 @@ The script will rely on the code repo specified in the upstream section of the m `autoupdate.strategy` is expected to be one of : - `latest_github_tag` : look for the latest tag (by sorting tags and finding the "largest" version). Then using the corresponding tar.gz url. Tags containing `rc`, `beta`, `alpha`, `start` are ignored, and actually any tag which doesn't look like `x.y.z` or `vx.y.z` - `latest_github_release` : similar to `latest_github_tags`, but starting from the list of releases. Pre- or draft releases are ignored. Releases may have assets attached to them, in which case you can define: -- `autoupdate.asset = "some regex"` (when there's only one asset to use). The regex is used to find the appropriate asset among the list of all assets. Note that the regex must follow [Python's regex implementation](https://docs.python.org/3/howto/regex.html#regex-howto) (for instance a double backslash is to be used as escape character). -- or several `autoupdate.asset.$arch = "some_regex"` (when the asset is arch-specific). The regex is used to find the appropriate asset for the specific arch among the list of assets + - `autoupdate.asset = "some regex"` (when there's only one asset to use). The regex is used to find the appropriate asset among the list of all assets + - or several `autoupdate.asset.$arch = "some_regex"` (when the asset is arch-specific). The regex is used to find the appropriate asset for the specific arch among the list of assets - `latest_github_commit` : will use the latest commit on github, and the corresponding tarball. If this is used for the 'main' source, it will also assume that the version is YYYY.MM.DD corresponding to the date of the commit. It is also possible to define `autoupdate.upstream` to use a different Git(hub) repository instead of the code repository from the upstream section of the manifest. This can be useful when, for example, the app uses other assets such as plugin from a different repository. @@ -314,6 +314,7 @@ Provision a system user to be used by the app. The username is exactly equal to ##### Properties - `allow_ssh`: (default: False) Adds the user to the ssh.app group, allowing SSH connection via this user - `allow_sftp`: (default: False) Adds the user to the sftp.app group, allowing SFTP connection via this user +- `allow_email`: (default: False) Enable authentication on the mail stack for the system user and send mail using `__APP__@__DOMAIN__`. A `mail_pwd` setting is automatically defined (similar to `db_pwd` for databases). You can then configure the app to use `__APP__` and `__MAIL_PWD__` as SMTP credentials (with host 127.0.0.1). You can also tweak the user-part of the domain-part of the email used by manually defining a custom setting `mail_user` or `mail_domain` - `home`: (default: `/var/www/__APP__`) Defines the home property for this user. NB: unfortunately you can't simply use `__INSTALL_DIR__` or `__DATA_DIR__` for now ##### Provision/Update