YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Merge branch 'YunoHost:master' into Alexis-IMBERT-patch-1

Browse source
This commit is contained in:
Alexis IMBERT 2024-02-27 19:49:27 +01:00 • committed by GitHub
commit 653ee834c2
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
27 changed files with 653 additions and 169 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md
View file

@ -45,7 +45,7 @@ Même si YunoHost est multi-domaine et multi-utilisateur, il reste **inappropri
Premièrement parce que le logiciel est trop jeune, donc non-testé et non-optimisé pour être mis en production pour des centaines d’utilisateurs en même temps. Et quand bien même, ce n’est pas le chemin que l’on souhaite faire suivre à YunoHost. La virtualisation se démocratise, et c’est une façon bien plus étanche et sécurisée de faire de la mutualisation.
Vous pouvez héberger vos amis, votre famille ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution.
Vous pouvez héberger vos amis, votre famille, votre association ou votre entreprise sans problème, mais vous devez **avoir confiance** en vos utilisateurs, et ils doivent de la même façon avoir confiance en vous. Si vous souhaitez tout de même fournir des services YunoHost à des inconnus, **un VPS entier par utilisateur** sera la meilleure solution.
## Logo

2
pages/02.administer/10.install/install.fr.md
View file

@ -372,7 +372,7 @@ Allez dans **Réglages** > **Réseau** :
## [fa=plug /] Démarrer la carte
* Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre carte).
* Pour les utilisateurs et utilisatrices souhaitant configurer la carte pour la connecter via le WiFi à la place, voir [cet exemple](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
* Pour les utilisateurs et utilisatrices souhaitant configurer la carte pour la connecter via le WiFi à la place, voir [cet exemple](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([ou là avant YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
* Mettez la carte SD dans le serveur.
* (Facultatif) Il est possible de brancher un écran et un clavier sur votre serveur en cas de soucis, pour vérifier que le processus de démarrage (boot) se passe bien, ou encore pour avoir un accès direct en console.
* Branchez l'alimentation.

4
pages/02.administer/10.install/install.md
View file

@ -505,7 +505,7 @@ Go to **Settings** > **Network**:
## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your board).
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([or here prior to YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
* Plug the SD card in your board
* (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
* Power up the board
@ -541,7 +541,7 @@ You should see a screen like this:
[/figure]
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="Installation classique sur un disque entier"]
[ui-tab title="Classic installation on a whole disk"]
!! N.B.: Once you have validated the keyboard layout, the installation will be launched and will completely erase the data on your hard disk!

2
pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md
View file

@ -120,5 +120,5 @@ If you can't restore your app but your system has been restored, you probably sh
yunohost tools regenconf nginx --force
```
After that you should be able to restore your apps. Don't forget to force upgrade theme if you have 502 errors.
After that you should be able to restore your apps. Don't forget to force upgrade them if you have 502 errors.

2
pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.md
View file

@ -69,7 +69,7 @@ Then restore the archive in the usual way.
### Restore large archives
If the available space is less than the weight of your archive, decompressed data and dependencies, you will have to restore part by part, app by app.
If restoring app by app is not enough OR if an archive is too big, it may be a good idea to generate a tarball without the "big" data of an app as if it had been generated with the [BACKUP_CORE_ONLY option] (/backup/include_exclude_files#don't-save-large-quantities-of-data). Example with Nextcloud:
If restoring app by app is not enough OR if an archive is too big, it may be a good idea to generate a tarball without the "big" data of an app as if it had been generated with the [BACKUP_CORE_ONLY option](/backup/include_exclude_files#don't-save-large-quantities-of-data). Example with Nextcloud:
```
app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost.backup/archives/ARCHIVE.tar
```

77
pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.it.md Normal file
View file

@ -0,0 +1,77 @@
---
title: DNS con IP dinamico
template: docs
taxonomy:
category: docs
routes:
default: '/dns_dynamicip'
---
! Prima di continuare, assicuratevi che il vostro indirizzo IP pubblico sia dinamico utilizzando: [ip.yunohost.org](http://ip.yunohost.org/). L'indirizzo IP del vostro router cambia quasi ogni giorno.
Questo tutorial cerca di risolvere il problema con gli IP dinamici: quando l'IP pubblico del vostro router cambia, la zona DNS non viene aggiornata per riflettere il nuovo indirizzo IP e di conseguenza il vostro server non è più raggiungibile con il nome di dominio.
Dopo aver applicato le configurazioni proposte in questo tutorial la redirezione dal vostro nome di dominio del vostro server all'IP reale non verrà più persa.
La configurazione che adotteremo consiste nel rendere automatica la comunicazione del router al servizio di DNS dinamico la variazione dell'indirizzo IP pubblico e che la zona DNS può essere aggiornata.
### Registrar
Di seguito un elenco, non esaustivo, dei registrar. Qui potere acquistare il vostro dominio:
* [OVH](http://ovh.com/)
* [GoDaddy](https://godaddy.com)
* [Gandi](http://gandi.net)
* [Namecheap](https://www.namecheap.com)
* [BookMyName](https://www.bookmyname.com)
* [Ionos](https://ionos.com)
* [Infomaniak](https://infomaniak.com)
Se siete in possesso di un dominio presso **OVH**, saltate al punto 4 e proseguite con il [tutorial](/OVH) considerando che OVH propone un servizio DynDNS.
#### 1. Create un account per il servizio DynDNS
Di seguito un elenco, non esaustivo, di offerte dei servizi DynDNS:
* [DNSexit](https://www.dnsexit.com/Direct.sv?cmd=dynDns)
* [No-IP](https://www.noip.com/remote-access)
* [ChangeIP](https://changeip.com/)
* [DynDNS (in italiano)](https://dyndns.it/)
* [Duck DNS](https://www.duckdns.org/)
* [ydns.io](https://ydns.io/)
Create un account presso il fornitore scelto. Dovrebbe comunicarvi uno (o più) indirizzi IP per raggiungere il servizio e un login (che dovreste poter configurare da soli).
#### 2. Configurate la zona DNS
Copiate la [zona DNS](/dns_config), tranne il record NS, del vostro [registrar](#registrar) verso il DNS dinamico del servizio DynDNS che avete scelto al punto 1 del tutorial.
#### 3. Reindirizzate la gestione del vostro dominio verso il server DNS dinamico
In questo passaggio informeremo il [registrar](#registrar) che il servizio DNS sarà affidato al servizio DyDNS.
Reindirizzate il campo NS verso l'indirizzo IP fornito dal servizio DyDNS.
In seguito cancellate la [zona DNS](/dns_config) (eccetto il precedente campo NS) nel vostro [registrar](#registrar).
## 4. Configurazione del router/client
Configurate il vostro router o un client specifico installato sul vostro server come ad esempio `ddclient` con i dati del vostro account DNS dinamico.
Qui useremo il client fornito dal router che è il sistema sicuramente più facile.
Inserite il login del servizio di DNS dinamico e l'indirizzo IP pubblico nel vostro router (l'interfaccia varierà sicuramente a seconda dell'ISP che state usando).
![](image://dns_dynamic-ip_box_conf.png?resize=600)

52
pages/02.administer/45.tutorials/05.domains/04.dns_local_network/dns_local_network.it.md Normal file
View file

@ -0,0 +1,52 @@
---
title: Accesso al server dalla rete locale
template: docs
taxonomy:
category: docs
routes:
default: '/dns_local_network'
---
Dopo aver concluso l'installazione del server, è possibile che il vostro dominio non sia accessibile dalla rete locale del server. Questo problema è noto con il nome di [hairpinning](http://en.wikipedia.org/wiki/Hairpinning) ed è una caratteristica non supportata da alcuni router.
Per risolvere questo problema dobbiamo:
- configurare i DNS del nostro router
- o in alternativa modificare il file /etc/hosts dei client dai quali vogliamo raggiungere il server
### Trovare l'indirizzo IP del server nella rete locale
Dobbiamo innanzitutto conoscere l'IP locale del server
- utilizziamo uno di questi [metodi](https://yunohost.org/en/finding_the_local_ip)
- dalla pagina di amministrazione, sezione Diagnostica > Connessione Internet > IPv4 cliccando su 'Dettagli' dovrebbe apparire il valore di 'IP locale'
- dal terminale con il comando: `hostname -I`
## Configurare il DNS del router
Andremo a creare un reindirizzamento attivo su tutta la LAN. Lo scopo è di creare, nel router, un reindirizzamento DNS verso l'IP del server YunoHost. Dobbiamo accedere all'interfaccia di configurazione del router, nella sezione DNS e creare il reindirizzamento nella LAN (ad esempio, `yunohost.local` invia a `192.168.1.21`).
### Box SFR
Se non trovate l'indirizzo IP privato lo potete trovare nel pannello di amministrazione:
Andate su Etichetta Network > Generale
<img src="/user/images/ip_serveur.png" width=800>
#### Configurare il DNS del box SFR
Andate all'etichetta Network > DNS e aggiungete il vostro nome a dominio al DNS del box.
<img src="/user/images/dns_9box.png" width=800>
## Configurare il file [hosts](https://en.wikipedia.org/wiki/Host_%28Unix%29) del client
L'opzione di modificare il file /etc/hosts deve essere presa in considerazione solo se non è possibile configurare il DNS del router, perché tale modifica avrà effetto solo sul pc specifico.
- In windows trovate il file qui:
`%SystemRoot%\system32\drivers\etc\`
> È necessario abilitare la visualizzazione dei file nascosti e di sistema per rendere visibile il file hosts.
- In sistemi UNIX (GNU/Linux, macOS), trovate il file qui:
`/etc/hosts`
> Dovrete avere i privilegi di root per modificare il file.
Aggiungete alla fine del file una riga contenente l'indirizzo IP del server seguito dal dominio
```bash
192.168.1.62 domain.tld
```

3
pages/02.administer/45.tutorials/15.filezilla/filezilla.fr.md
View file

@ -68,9 +68,10 @@ Sources
Depuis n'importe quel GNU/Linux récent, vous devriez pouvoir utiliser le gestionnaire de fichiers pour accéder à votre serveur.
Nautilus de Gnome3 intègre de base des fonctionnalités similaires à FileZilla :
Nautilus de Gnome3 et Dolphin de KDE intègrent de base des fonctionnalités similaires à FileZilla :
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
* <https://docs.kde.org/stable5/en/dolphin/dolphin/location-bar.html#location-bar-editable-kioslaves>
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
### Sous Windows

82
pages/02.administer/45.tutorials/15.filezilla/filezilla.it.md Normal file
View file

@ -0,0 +1,82 @@
---
title: Scambiare i files con il proprio server tramite un'interfaccia grafica.
template: docs
taxonomy:
category: docs
routes:
default: '/filezilla'
---
Questa parte spiega come scambiare dei files (backup, musica, foto, video...) con il proprio server, servendosi di un'interfaccia grafica. Utilizzeremo un metodo alternativo al tradizionale comando `scp` perché troppo tecnico e criptico, o alla installazione di un'applicazione come Nextcloud.
Per compiere questa operazione utilizzeremo [FileZilla](https://filezilla-project.org/), un software libero disponibile per Windows, GNU/Linux et macOS.
## Scaricare e installare FileZilla
Potete scaricare FileZilla [da questa pagina](https://filezilla-project.org/download.php?type=client). Il sito dovrebbe proporvi automaticamente la versione adatta al vostro sistema operativo. Nel caso contrario seguite le istruzioni per installare il [client](https://wiki.filezilla-project.org/Client_Installation) corretto.
Installate e lanciate *FileZilla*
## Configurazione
1. Cliccate sull'icona in alto a sinistra *Site Manager*.
![Pagina principale di Filezilla](image://filezilla_1.png)
2. Cliccate su **New Site** e assegnate un nome al server che volete connettere: in questo esempio *Family*. Completate i parametri come nell'immagine (con i vostri dati) e cliccate su **Connect** (N.B. : se volete editare i file dell'applicazione [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh), dovrete utilizzare un utente diverso da `admin`. Fate riferimento alla documentazione di custom webapp).
![Schermata del site manager](image://filezilla_2.png)
3. Apparirà un avviso poiché vi state collegando per la prima volta al server. *Se è la prima connessione, potete ignorarlo*
![Avviso per la fingerprint del server sconosciuta](image://filezilla_3.png)
4. Filezilla vi chiederà la password di `admin` del server.
![schermata per la richiesta della password](image://filezilla_4.png)
5. Una volta salvato nei segnalibri, il server verrà salvato e vedrete questa schermata.
![Schermata del "site manager" con il server appena aggiunto](image://filezilla_5.png)
## Utilizzo
1. Collegatevi al server con le credenziali salvate in precedenza. *A volte viene richiesta la password*
La parte sinistra della finestra del programma si riferisce al vostro pc. La parte destra corrisponde al server YunoHost remoto. Potete navigare tra file e cartelle e effettuare drag-and-drop tra i due computer.
![vista della connessione al server remoto](image://filezilla_6.png)
2. Nel pannello di destra, raggiungete `/home/yunohost.backup/archives` dove si trovano gli [archivi di backup](https://yunohost.org/it/backup)
![la directory dove si trovano i backup di YunoHost](image://filezilla_7.png)
! [fa=cloud-download /] Assicuratevi di scaricare i file `.tar.gz` e `.json`
![Copia dei backup da YunoHost ad un computer locale](image://filezilla_8.png)
----
Link a fonti esterne:
* [Documentazione ufficiale](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en))
* [Tutorial generale su FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
## Alternative a FileZilla
### GNU/Linux
Qualsiasi distribuzione recente di GNU/Linux dovrebbe permettere di accedere al server remoto utilizzando il gestore dei file.
Nautilus di Gnome3 integra delle funzionalità simili a FileZilla:
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
### Windows
* [WinSCP](https://winscp.net/) è un ottimo programma per Windows
### MacOS
* [Cyberduck](https://cyberduck.io/) un programma libero per macOS

3
pages/02.administer/45.tutorials/15.filezilla/filezilla.md
View file

@ -68,9 +68,10 @@ Sources
From any recent GNU/Linux, you should be able to use the `file manager` to reach your server.
Nautilus from Gnome3 has features similar to FileZilla, out of the box.
Nautilus from Gnome3 and Dolphin from KDE have features similar to FileZilla, out of the box.
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
* <https://docs.kde.org/stable5/en/dolphin/dolphin/location-bar.html#location-bar-editable-kioslaves>
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
### Windows

253
pages/02.administer/45.tutorials/25.external_storage/external_storage.it.md Normal file
View file

@ -0,0 +1,253 @@
---
title: Aggiungere un disco esterno al vostro server
template: docs
taxonomy:
category: docs
routes:
default: '/external_storage'
aliases:
- '/moving_app_folder'
---
## Introduzione
Oltre al monitoraggio delle dimensioni delle partizioni (che controlla che non siano troppo piccole), YunoHost non si occupa, al momento, dell'organizzazione delle partizioni dei vostri dischi.
Se la vostra configurazione è basata su una board ARM con scheda SD, oppure il server dispone di un disco SSD di piccole dimensioni, potreste, per motivi di spazio o di sicurezza, voler aggiungere uno o più dischi al vostro server.
! Se avete esaurito lo spazio sul disco del vostro server, potete provare con il comando `apt clean` per tentare di recuperarne un po' e avere modo di seguire le istruzioni di seguito riportate.
Troverete qui le istruzioni per riuscire a spostare i vostri dati su un disco esterno in modo corretto e con un impatto minimo sul funzionamento di YunoHost. Potete eseguire lo spostamento durante l'installazione o in un secondo momento, quando si presenterà la necessità di più spazio o temete per l'affidabilità della scheda SD.
!!! Il procedimento presentato qui inizia montando l'unica partizione del disco, in seguito utilizza una o più sotto-cartelle per creare diversi punti di montaggio sull'albero del file system del pc. Questo metodo è preferibile rispetto al utilizzo di link simbolici poiché questi possono entrare in conflitto con alcune applicazioni, tra le quali il sistema di backup di YunoHost. Potreste scegliere di montare le partizioni invece che le sotto-cartelle, ma sorge la difficoltà di prevedere la stima della dimensione della cartella.
## [fa=list-alt /] Prerequisiti
* Prevedere un periodo temporale nel quale gli utenti del vostro server possono sopportare una interruzione dei servizi. I passaggi da compiere, anche se relativamente semplici, sono tecnicamente complessi e necessitano di un lasso di tempo **da dedicare in modo esclusivo**.
* Conoscenza della connessione come root sul server anche via [SSH](/ssh). (Nota bene: se siete connessi come utente `admin`, potete passare root con il comando `sudo su`)
* Conoscere i comandi `cd`, `ls`, `mkdir`, `rm`.
* Disporre di un backup nel caso le cose non vadano come previsto
* Disporre di un disco aggiuntivo (SSD, hard disk, chiavetta USB) collegato al server via USB o SATA
## 1. Identificare le cartelle da spostare
Il comando `ncdu` vi permette di navigare tra le cartelle del vostro server affinché possiate conoscerne la loro dimensione.
Di seguito, alcuni esempi di percorsi che possono essere di notevoli dimensioni e qualche consiglio su come ridurre la loro dimensione o perché sceglierli tra quelli da spostare.
| Percorso | Contenuto | Consigli |
|-----------------------------|----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `/home` | Cartelle Utenti accessibile via SFTP | Spostabile |
| `/home/yunohost.backup` | Backup di YunoHost | In base alla vostra strategia di backup è consigliabile spostare questa cartella su un disco diverso da quello che contiene i dati e i database |
| `/home/yunohost.app` | Cartella di grandi dimensioni contenente i dati delle varie applicazioni (nextcloud, matrix) | Spostabile |
| `/home/yunohost.multimedia` | Cartella di grandi dimensioni condivisa tra varie applicazioni (nextcloud, matrix) | Spostabile |
| `/var/lib/msql` | Database utilizzato dalle applicazioni | Per motivi di velocità è consigliato lasciarlo sul disco principale |
| `/var/lib/postgresql` | Database utilizzato dalle applicazioni | Per motivi di velocità è consigliato lasciarlo sul disco principale |
| `/var/mail` | Mail degli utenti | Spostabile |
| `/var/www` | Cartella delle applicazioni WEB | Per motivi di velocità è consigliato lasciarla sul disco principale |
| `/var/log` | Log degli eventi (messaggi di errore, connessioni...) | Questa cartella dovrebbe essere di dimensioni ridotte, in caso contrario potrebbe esserci un errore nella rotazione dei log che deve essere risolto. |
| `/opt` | Programmi e dipendenze di alcune applicazioni YunoHost | Per motivi di velocità è consigliato lasciare sul disco principale. Per le applicazioni nodejs è possibile recuperare dello spazio cancellando le versioni non in uso |
| `/boot` | Kernel e file di avvio | Non spostare se non perfettamente a conoscenza delle possibili conseguenze. Si possono eliminare vecchi kernel non in uso |
## 2. Collegare e identificare il disco
Collegate il disco al server e identificate il nome assegnato dal sistema.
Utilizzate il comando:
```bash
lsblk
```
La risposta potrebbe essere qualcosa di simile
```bash
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
sda 8:0 0 931.5G 0 disk
└─sda1 8:1 0 931.5G 0 part
mmcblk0 179:0 0 14.9G 0 disk
├─mmcblk0p1 179:1 0 47.7M 0 part /boot
└─mmcblk0p2 179:2 0 14.8G 0 part /
```
In questo caso `mmcblk0` corrisponde ad una scheda SD di 16 GB (si nota che le partizioni `mmcblk0p1` e `mmcblk0p2` corrispondono rispettivamente alla partizione di `/boot` e alla partizione di sistema `/`). Il disco esterno collegato corrisponde a `sda`, ha una capacità di circa 1GB, e contiene una sola partizione `sda1` che non è montata (non ha nessun riferimento nella colonna "MOUNTPOINT").
! [fa=exclamation-triangle /] In alcuni casi il sistema operativo è installato su `sda` e di conseguenza il vostro disco sarà `sdb`
!!! Suggerimento! se la dimensione del disco non è sufficiente per essere riconosciuto, potete scollegare il disco e eseguire il comando `lsblk`, ricollegare il disco, eseguire nuovamente `lsblk` e osservare le differenze di output.
## 3. Formattare il disco (Se necessario)
Se il vostro disco è formattato con un filesystem supportato da Linux (quindi non FAT32 o NTFS) potete andare al punto successivo, diversamente.
Create un partizione sul disco:
```bash
fdisk /dev/miodisco
```
digitate in sequenza `n`, `p`, `1`, `Invio`, `Invio`, `w` per creare una nuova partizione
Controllate con `lsblk` che il vostro disco contenga solo una partizione.
Prima di poter essere utilizzato il disco deve essere formattato.
! [fa=exclamation-triangle /] **Se il vostro disco è già formattato potete saltare questa parte. La formattazione di un disco comporta la cancellazione di tutti i dati presenti! Ponete attenzione nel digitare il nome del disco, potreste formattare un disco diverso da quello dove volete intervenire! Nell'esempio sopra, il disco si chiama `/dev/sda`. Se il vostro disco è già formattato potete saltare questa parte.
Per formattare la partizione digitate :
```bash
mkfs.ext4 /dev/miodisco
# e poi 'y' per confermare
```
Sostituite `miodisco` con il nome della prima partizione del disco di destinazione, nel nostro esempio `sda1`.
!!! Potete variare queste istruzioni se volete creare un volume raid 1 o cifrare la cartella.
## 4. Montare il disco
Contrariamente a Windows, dove i dischi sono contraddistinti da lette (C:/), in linux i dischi sono accessibili dall'albero del gestore dei file. "Montare" un disco significa renderlo accessibile nell'albero dei file. Sceglieremo di montare il disco in `/mnt/hdd` ma possiamo anche assegnare un nome di fantasia. (Ad esempio `/mnt/disco` ...).
Iniziamo creando la directory:
```bash
mkdir /mnt/hdd
```
Montiamo il disco con il comando:
```bash
mount /dev/miodisco /mnt/hdd
```
(In questo caso, `/dev/miodisco` corrisponde alla prima partizione del disco)
## 5. Montare una cartella /mnt/hdd nella cartella che contiene i dati da spostare
Ipotizzeremo, di seguito, lo spostamento delle mail e di una notevole quantità di dati delle applicazioni, che si trovano in `/home/yunohost.app`.
### 5.1 Creazione delle sotto cartelle sul disco
Iniziamo creando due cartelle nel disco di destinazione.
```bash
mkdir -p /mnt/hdd/home/yunohost.app
mkdir -p /mnt/hdd/var/mail
```
### 5.2 Passaggio alla modalità manutenzione
Precauzionalmente portiamo nello stato di manutenzione le applicazioni che potrebbero scrivere dei dati nella cartella che vogliamo spostare.
Ad esempio, per nextcloud:
```bash
sudo -u nextcloud /var/www/nextcloud/occ maintenance:mode --on
```
Per la mail:
```bash
systemctl stop postfix
systemctl stop dovecot
```
! Se desiderate spostare dei database come ad esempio mariadb (mysql), dovete necessariamente fermare i servizi del database, pena la corruzione dei dati.
### 5.3 Creazione dei punti di montaggio
Procediamo con rinominare la cartella di origine e crearne una fittizia
```bash
mv /home/yunohost.app /home/yunohost.app.bkp
mkdir /home/yunohost.app
mv /var/mail /var/mail.bkp
mkdir /var/mail
```
Servendoci del comando `mount --bind` montiamo la cartella del nostro disco nel nuovo ramo dell'albero dei file.
```bash
mount --bind /mnt/hdd/home/yunohost.app /home/yunohost.app
mount --bind /mnt/hdd/var/mail /var/mail
```
### 5.4 Copia dei dati
Copiamo quindi i dati, mantenendo le proprietà delle cartelle e dei file. Questa operazione può impiegare un po' di tempo, aprendo un altro terminale potete seguire la progressione dell'operazione osservando la dimensione del punto di montaggio con il comando `df -h`
```bash
cp -a /home/yunohost.app.bkp/. /home/yunohost.app/
cp -a /var/mail.bkp/. /var/mail/
```
Terminata la copia, assicuratevi che sia andato tutto a buon fine con il comando `ls`
```bash
ls -la /home/yunohost.app/
ls -la /var/mail/
```
### 5.5 Uscita dalla modalità manutenzione
Da questo momento potete uscire dalla modalità manutenzione, il comando illustrato qui sotto va adattato in base ai servizi che avevate sospeso o arrestato.
```bash
sudo -u nextcloud /var/www/nextcloud/occ maintenance:mode --off
systemctl start postfix
systemctl start dovecot
```
Dopo aver impartito i comandi di avvio, le applicazioni e i servizi sfrutteranno il disco esterno per i loro dati. Dobbiamo quindi effettuare qualche test per capire in quale misura la velocità di esecuzione è impattata dal disco esterno (in particolar modo se il disco utilizza l'interfaccia USB 2.0).
## 6. Automatizzare il montaggio all'avvio
Fino ad ora, abbiamo montato manualmente il disco e le sotto cartelle. È però necessario configurare il sistema affinché il disco esterno venga montato in automatico ad ogni avvio.
Se i test di velocità sono soddisfacenti, bisogna rendere definitivo il punto di montaggio. In caso contrario affrettatevi a fare dietro front iniziando a ripristinare la modalità di manutenzione.
Iniziamo cercando l'UUID (universal identifier, identificatore universale) del nostro disco:
```bash
blkid | grep "/dev/miodisco"
# Restituisce una stringa del tipo :
# /dev/sda1:UUID="cea0b7ae-2fbc-4f01-8884-3cb5884c8bb7" TYPE="ext4" PARTUUID="34e4b02c-02"
```
Aggiungiamo una riga di codice al file `/etc/fstab` deputato alla gestione dei montaggi dei dischi all'avvio. Aprite il file con `nano`:
```bash
nano /etc/fstab
```
Digitiamo questa riga in fondo al file:
```bash
UUID="cea0b7ae-2fbc-4f01-8884-3cb5884c8bb7" /mnt/hdd ext4 defaults,nofail 0 0
/mnt/hdd/home/yunohost.app /home/yunohost.app none defaults,bind 0 0
/mnt/hdd/var/mail /var/mail none defaults,bind 0 0
```
(dovremo modificare la riga in base alle nostre scelte precedenti)
Salvate le modifiche con CTRL+x e `o`.
Riavviate il server per assicurarvi che il disco e le sotto cartelle vengano montate in automatico.
## 7. Cancellare i dati precedenti
Quando siete sicuri che la configurazione sia corretta, potete procedere alla cancellazione della configurazione creata nel punto 5.3:
```bash
rm -Rf /home/yunohost.app.bkp
rm -Rf /var/mail.bkp
```
### ![](image://tada.png?resize=32&classes=inline) Complimenti!!!
Se siete giunti fino qui senza incidenti, avete configurato un server che sfrutta uno o più dischi per il salvataggio dei dati.

2
pages/02.administer/45.tutorials/25.external_storage/external_storage.md
View file

@ -238,7 +238,7 @@ Use Ctrl+X then `y` to save.
You can then try rebooting the system to check if the disk and subfolders are mounted automatically.
## 7. Clean up old data
Once your new setup is validated, you can proceed to delete the old data from step 6.3:
Once your new setup is validated, you can proceed to delete the old data from step 5.3:
```bash
rm -Rf /home/yunohost.app.bkp

5
pages/02.administer/45.tutorials/60.security/security.fr.md
View file

@ -61,7 +61,8 @@ sudo yunohost settings set security.ssh.password_authentication -v no
### Modifier le port SSH
Pour éviter des tentatives de connexion SSH par des robots qui scannent tout Internet pour tenter des connexions SSH avec tout serveur accessible, on peut modifier le port SSH.
C'est géré par un paramètre système, qui se charge de configurer les services SSH et Fail2Ban.
C'est géré par un paramètre système, qui se charge de configurer les services SSH et Fail2Ban.
Il n'est pas utile de modifier ce port si vous avez désactivé l'authentification par mot de passe.
```bash
sudo yunohost settings set security.ssh.port -v <votre_numero_de_port_ssh>
@ -84,11 +85,13 @@ La configuration TLS par défaut des services tend à offrir une bonne compatibi
Changer le niveau de compatibilité n'est pas définitif et il est possible de rechanger le paramètre si vous concluez qu'il faut revenir en arrière.
**Sur votre serveur**, modifiez la politique pour NGINX :
```bash
sudo yunohost settings set security.nginx.compatibility -v modern
```
**Sur votre serveur**, modifiez la politique pour SSH :
```bash
sudo yunohost settings set security.ssh.compatibility -v modern
```

6
pages/02.administer/45.tutorials/60.security/security.md
View file

@ -51,12 +51,14 @@ Type your admnistration password and your key will be copied onto your server.
```bash
sudo yunohost settings set security.ssh.password_authentication -v no
```
---
### Modify the SSH port
To prevent SSH connection attempts by robots that scan the internet for any server with SSH enabled, you can change the SSH port.
This is handled by a system setting, which takes care of updating the SSH and Fail2Ban configuration.
This is handled by a system setting, which takes care of updating the SSH and Fail2Ban configuration.
There's no need to change this port if you've disabled password authentication.
! If you modify anything in the `/etc/ssh/sshd_config` file, even if only the port, YunoHost will no longer manage this file. For this reason, always use the YunoHost admin tools to make changes to the systems configuration files!
@ -81,11 +83,13 @@ The default TLS configuration for services tends to offer good compatibility to
Changing the compatibility level is not definitive and can be reverted if it doesn't fit with your environment.
**On your server**, change the policy for NGINX
```bash
sudo yunohost settings set security.nginx.compatibility -v modern
```
**On your server**, change the policy for SSH
```bash
sudo yunohost settings set security.ssh.compatibility -v modern
```

2
pages/02.administer/50.troubleshooting/10.admin_password/change_admin_password.it.md
View file

@ -22,5 +22,5 @@ Poi vai su Strumenti > Cambia password amministrazione.
```bash
yunohost tools adminpw
yunohost tools rootpw
```

2
pages/02.administer/50.troubleshooting/20.ipv6/ipv6.fr.md
View file

@ -25,7 +25,7 @@ Sur le panneau de gestion d'OVH, vous aller récupérer 3 informations :
- l'adresse passerelle IPv6
- le préfixe IPv6. Les offres VPS SSD d'OVH ne fournissent qu'**une** seule adresse IPV6, le préfixe est donc `/128`
Sur votre VPS, vous aller créer une sauvegarde de votre fichier de configuration des interfaces réseau dans votre répertoire home avec la commande : `cp /etc/network/interfaces ~/interfaces`.
Sur votre VPS, vous allez créer une sauvegarde de votre fichier de configuration des interfaces réseau dans votre répertoire home avec la commande : `cp /etc/network/interfaces ~/interfaces`.
2 possibilités pour inscrire vos données ipv6 :
1/ vous pouvez modifier le fichier de configuration `/etc/network/interfaces`

2
pages/02.administer/55.providers/10.isp/free/isp_free.fr.md
View file

@ -19,7 +19,7 @@ Rendez-vous sur la [console d'administration du site de free](https://subscribe.
##### Freebox v6 (Revolution / Mini4k)
Allez à l’adresse : [mafreebox.free.fr](http://mafreebox.free.fr/) puis authentifiez-vous.
Allez à l’adresse : [mafreebox.freebox.fr](http://mafreebox.freebox.fr) puis authentifiez-vous.
#### Ouverture des ports

2
pages/02.administer/55.providers/10.isp/isp.md
View file

@ -32,7 +32,7 @@ Here is a non-comprehensive list of internet service providers by country, which
* [South Korea](/isp/country:kor)
[/ui-tab]
[ui-tab title="Europa"]
[ui-tab title="Europe"]
* [Belgium (nl)](/isp/country:belnl)
* [Belgium (fr)](/isp/country:belfr)

2
pages/02.administer/55.providers/15.vpn/vpn.md
View file

@ -51,7 +51,7 @@ Below, you can find a list of providers compatible for self-hosting and especial
| [Igwan.net](https://igwan.net) | ✘ (L2TP/IPSec) | ? | ? | ? | 4 ou 8€ / mois | ? / an | <span class="ffdn">FFDN</span> <span class="label label-success label-as-badge">Non Profit</span> |
| [Illyse](https://www.illyse.net/acces-internet-par-vpn/) | ✔ (manuelle) | ✔ | ✔ | ✔ | 6 ou 8€ / mois | 20€ / an | <span class="ffdn">FFDN</span> <span class="label label-success label-as-badge">Non Profit</span> |
| [ILOTH](https://iloth.net/vpn/) | ✔ (.cube) | ✘ | ✔ | ✘ | 80€ / an | 5 à 100€ / an | <span class="ffdn">FFDN</span> <span class="label label-success label-as-badge">Non Profit</span> |
| [Milkywan](https://milkywan.fr/prices#popupTunnel) | ✔ (manuelle) | ✔ | ✔ | ✔ | 5 € / mois | incluse | |
| [Milkywan](https://milkywan.fr/prices#popupTunnel) | ✔ (manuelle) | ✔ | ✔ | ✔ | 5 € / mois | incluse | <span class="label label-success label-as-badge">Non Profit</span> |
| [Mycélium](https://mycelium-fai.org/wiki/documentation/services/vpn) | ✔ (manuelle) | ✘ | ✘ | ✘ | Prix libre | incluse<br>Réservé aux nordistes(FR 59) | <span class="ffdn">FFDN</span> <span class="label label-success label-as-badge">Non Profit</span> |
| [Neutrinet](https://neutrinet.be/en/vpn) | ✔ (.cube + [internetcube](https://internetcu.be)) | ✔ | ✔ | ? | ~8 €¹ / mois | incluse | <span class="ffdn">FFDN</span> <span class="label label-success label-as-badge">Non Profit</span> |
| [Rézine](https://www.rezine.org/acces_internet/tunnels_chiffr%C3%A9s/) | ✔ (manuelle) | ✔ | ✔ | ✔ | 5 à 10€ / mois | Prix libre | <span class="ffdn">FFDN</span> <span class="label label-success label-as-badge">Non Profit</span> |

2
pages/03.user_guide/05.emailclients/email_configure_client.fr.md
View file

@ -34,6 +34,7 @@ Pour configurer manuellement un nouveau compte dans Thunderbird commencez par re
* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
[/ui-tab]
[ui-tab title="K-9 Mail"]
##### ![](image://k9mail.png?resize=50&classes=inline) Configurer K-9 Mail (sur Android)
@ -45,6 +46,7 @@ Suivez les instructions suivantes (comme pour Thunderbird, il vous faudra peut-
![](image://k9mail_config_4.png?resize=280&classes=inline)
[/ui-tab]
[ui-tab title="Dekko"]
##### ![](image://dekko-app.png?resize=50&classes=inline) Configurer Dekko (sur Ubuntu Touch)

30
pages/04.applications/10.docs/baikal/app_baikal.md
View file

@ -11,9 +11,9 @@ routes:
[![Install Baïkal with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=baikal) [![Integration level](https://dash.yunohost.org/integration/baikal.svg)](https://dash.yunohost.org/appci/app/baikal)
Baïkal is a server for calendars and address books, which uses the CalDav and CardDav protocol. Baïkal can be synced with a lot of clients, like Thunderbird + Lightning.
Baïkal is a server for calendars and address books, which uses the CalDAV and CardDAV protocol. Baïkal can be synced with a lot of clients, like Thunderbird + Lightning.
**WARNING**: Baïkal will not work if you have installed a **Nextcloud** (the Nextcloud CardDav/CalDav functions conflict).
**WARNING**: Baïkal will not work if you have installed a **Nextcloud** (the Nextcloud CardDAV/CalDAV functions conflict).
## Configuration
@ -28,25 +28,31 @@ By default, Baïkal is configured to look for users in YunoHost's LDAP
directory. YunoHost's users will appear under `User and ressources` menu after their
first authentication.
### CalDAV/CardDAV access
To be able to connect CalDAV or CardDAV clients to Baïkal, you must allow access to the app for visitors during installation.
Clients will still need to to authenticate with username and password of an YNH user.
Also note that the admin interface of Baïkal is always available only to logged-in YNH admin users.
## CalDAV connection
### Connecting Thunderbird with Lightning
Add a new agenda with type "Network" and "CalDAV"
The new URL to add is:
https://domain.org/baikal/cal.php/calendars/username/default
Be careful to replace "domain.org" with your own domain and the "username" with your username.
- Open the Calendar view, select "New Calendar...".
- Choose "On the Network", click "Next".
- Type in your YNH username in the "Username" input field and your server's "https://domain.tld" in the "Location" input field.
- (You only need to enter the domain, Baïkal configures the webserver to forward CalDAV and CardDAV requests to Baïkal.)
- Click "Find Calendars" and enter your YNH user's password.
- If this is the first time your YNH user logs in to Baïkal, a "Default Calendar" is automatically created for you.
- Select the calendar you want to add to Thunderbird and click "Subscribe".
### Connecting to AgenDAV
AgenDAV is a web client for using your calendars. It's packaged for YunoHost and you can used it after installing Baïkal.
AgenDAV is a web client for using your calendars. It's packaged for YunoHost and you can use it after installing Baïkal.
AgenDAV is already connected to Baïkal, any other configuration is necessary. If you create a new entry in Thunderbird + Lightning calendar, refresh your AgenDAV page is enough to see your modifications.
AgenDAV is already connected to Baïkal, no other configuration is necessary. If you create a new entry in Thunderbird + Lightning calendar, refreshing your AgenDAV page is enough to see your modifications.
AgenDAV also allows you to create a new calendars very easily.
AgenDAV also allows you to create new calendars very easily.
## CardDAV Connection

3
pages/05.community/10.chat_rooms/chat_rooms.md
View file

@ -7,13 +7,14 @@ routes:
default: '/chat_rooms'
---
Amoung other communication tools, YunoHost project use chat rooms to communicate.
Among other communication tools, YunoHost project use chat rooms to communicate.
You could join those chat rooms using:
- an [IRC Client](https://en.wikipedia.org/wiki/Comparison_of_Internet_Relay_Chat_clients) for example [KiwiIRC](https://web.libera.chat/#yunohost)
- an [XMPP client](https://en.wikipedia.org/wiki/Comparison_of_instant_messaging_clients)
- a [Matrix client](https://matrix.org/docs/guides/faq.html#what-clients-are-available%3F)
**NB: Currently, the IRC bridge ([due to Matrix](https://libera.chat/guides/faq#are-bridges-allowed)) is disabled. So while the XMPP and Matrix are bridged, the IRC channel is not.**
#### Help and support chat room

2
pages/06.contribute/05.write_documentation/03.git/doc_use_git.md
View file

@ -39,7 +39,7 @@ When you've already create a Pull Request (PR), changes to your development bran
YunoHost has a specific Git repository to collect issues: [github.com/YunoHost/issues](https://github.com/YunoHost/issues)
An issue, also called a ticket, is an identified problem or a development wish; in this case for documentation, but it is valid for any software repository. Within the framework of the YunoHost documentation it will be mainly proposed issues for the development of the documentation, the identified problems being easily correctable.
## Going further with Git and working on his workstation
## Going further with Git and working on your workstation
Using the power of Git to work on your personal computer means you don't have to create a `commit` each time you save modified documentation pages. It also allows you to use tools and software that make it easier to distinguish between tags used in a documentation page.
- Online resource: [docs.microsoft.com - Setting up a Git repository locally for documentation](https://docs.microsoft.com/fr-fr/contribute/get-started-setup-local)

2
pages/06.contribute/10.packaging_apps/60.advanced/20.config_panels/config_panels.md
View file

@ -84,7 +84,7 @@ The `bind` property allows to define where read and write the value bind to the
#### Default behaviour
If you did not define a specific getter/setter (see below), and no `bind` argument was defined, YunoHost will read/write the value from/to the app's `/etc/yunohost/$app/settings.yml` file.
If you did not define a specific getter/setter (see below), and no `bind` argument was defined, YunoHost will read/write the value from/to the app's `/etc/yunohost/apps/$app/settings.yml` file.
#### Read / write into a var of an actual configuration file

243
pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md
View file

@ -7,7 +7,7 @@ routes:
default: '/packaging_apps_helpers'
---
Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/doc/generate_helper_doc.py) on 27/11/2023 (YunoHost version 11.2.7)
Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/doc/generate_helper_doc.py) on 20/02/2024 (YunoHost version 11.2.10.1)
## APPS
@ -25,7 +25,7 @@ Requires YunoHost version *.*.* or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apps#L9)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/apps#L9)
[/details]
----------------
@ -41,7 +41,7 @@ Requires YunoHost version *.*.* or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apps#L65)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/apps#L65)
[/details]
----------------
@ -70,7 +70,7 @@ If the app relies on a specific PHP version, then `php` will be aliased that ver
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apps#L128)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L53)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L75)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L107)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L117)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L128)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L138)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L148)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L225)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L338)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L357)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/apt#L391)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L64)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L179)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L238)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L306)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L357)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L397)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L432)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/backup#L480)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/backup#L480)
[/details]
----------------
@ -585,7 +585,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/fail2ban#L62)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/fail2ban#L62)
[/details]
----------------
@ -599,7 +599,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/fail2ban#L134)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/fail2ban#L134)
[/details]
----------------
@ -627,7 +627,7 @@ Requires YunoHost version 3.8.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/hardware#L13)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/hardware#L13)
[/details]
----------------
@ -650,7 +650,7 @@ Requires YunoHost version 3.8.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/hardware#L75)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/hardware#L75)
[/details]
----------------
@ -671,7 +671,7 @@ Requires YunoHost version 2.4.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L10)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L10)
[/details]
----------------
@ -688,7 +688,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L30)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L30)
[/details]
----------------
@ -705,7 +705,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L56)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L56)
[/details]
----------------
@ -722,7 +722,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L73)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L73)
[/details]
----------------
@ -741,7 +741,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L92)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L92)
[/details]
----------------
@ -760,7 +760,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L113)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L113)
[/details]
----------------
@ -779,7 +779,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L134)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L134)
[/details]
----------------
@ -798,7 +798,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L155)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L155)
[/details]
----------------
@ -817,7 +817,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L176)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L176)
[/details]
----------------
@ -836,7 +836,7 @@ Requires YunoHost version 11.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L197)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L197)
[/details]
----------------
@ -856,7 +856,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L257)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L257)
[/details]
----------------
@ -871,7 +871,7 @@ Requires YunoHost version 3.6.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logging#L345)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logging#L345)
[/details]
----------------
@ -881,26 +881,21 @@ Requires YunoHost version 3.6.0 or higher.
#### ynh_use_logrotate
[details summary="<i>Use logrotate to manage the logfile</i>" class="helper-card-subtitle text-muted"]
**Usage**: `ynh_use_logrotate [--logfile=/log/file] [--nonappend] [--specific_user=user/group]`
**Usage**: `ynh_use_logrotate [--logfile=/log/file] [--specific_user=user/group]`
**Arguments**:
- `-l`, `--logfile=`: absolute path of logfile
- `-n`, `--nonappend`: (optional) Replace the config file instead of appending this new config.
- `-u`, `--specific_user=`: run logrotate as the specified user and group. If not specified logrotate is runned as root.
**Details**:<br/>
If no `--logfile` is provided, `/var/log/$app` will be used as default.
`logfile` can point to a directory or a file.
It's possible to use this helper multiple times, each config will be added to
the same logrotate config file. Unless you use the option `--non-append`
Requires YunoHost version 2.6.4 or higher.
Requires YunoHost version 3.2.0 or higher for the argument `--specific_user`
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logrotate#L18)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logrotate#L15)
[/details]
----------------
@ -914,7 +909,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/logrotate#L110)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/logrotate#L99)
[/details]
----------------
@ -931,7 +926,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/multimedia#L11)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/multimedia#L11)
[/details]
----------------
@ -951,7 +946,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/multimedia#L64)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/multimedia#L64)
[/details]
----------------
@ -968,7 +963,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/multimedia#L93)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/multimedia#L93)
[/details]
----------------
@ -1001,7 +996,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L15)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L15)
[/details]
----------------
@ -1019,7 +1014,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L36)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L36)
[/details]
----------------
@ -1037,7 +1032,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L60)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L60)
[/details]
----------------
@ -1058,7 +1053,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L128)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L128)
[/details]
----------------
@ -1077,7 +1072,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L160)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L160)
[/details]
----------------
@ -1099,7 +1094,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L198)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L198)
[/details]
----------------
@ -1117,7 +1112,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/mysql#L224)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/mysql#L224)
[/details]
----------------
@ -1141,7 +1136,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/network#L12)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/network#L12)
[/details]
----------------
@ -1162,7 +1157,7 @@ Requires YunoHost version 3.8.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/network#L36)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/network#L36)
[/details]
----------------
@ -1183,7 +1178,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/network#L99)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/network#L99)
[/details]
----------------
@ -1204,7 +1199,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/network#L119)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/network#L119)
[/details]
----------------
@ -1232,7 +1227,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/nginx#L19)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/nginx#L19)
[/details]
----------------
@ -1246,12 +1241,12 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/nginx#L41)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/nginx#L41)
[/details]
----------------
#### ynh_change_url_nginx_config
[details summary="<i>Move / regen the nginx config in a change url context</i>" class="helper-card-subtitle text-muted"]
[details summary="<i>Regen the nginx config in a change url context</i>" class="helper-card-subtitle text-muted"]
**Usage**: `ynh_change_url_nginx_config`
@ -1260,7 +1255,7 @@ Requires YunoHost version 11.1.9 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/nginx#L52)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/nginx#L52)
[/details]
----------------
@ -1314,7 +1309,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/nodejs#L52)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/nodejs#L52)
[/details]
----------------
@ -1338,7 +1333,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/nodejs#L92)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/nodejs#L92)
[/details]
----------------
@ -1356,7 +1351,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/nodejs#L165)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/nodejs#L165)
[/details]
----------------
@ -1429,7 +1424,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L66)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L66)
[/details]
----------------
@ -1448,7 +1443,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L152)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L152)
[/details]
----------------
@ -1466,7 +1461,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L169)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L169)
[/details]
----------------
@ -1489,7 +1484,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L192)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L192)
[/details]
----------------
@ -1512,7 +1507,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L260)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L260)
[/details]
----------------
@ -1533,7 +1528,7 @@ Requires YunoHost version 3.7.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L329)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L329)
[/details]
----------------
@ -1548,7 +1543,7 @@ Requires YunoHost version 4.1.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L359)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L359)
[/details]
----------------
@ -1559,7 +1554,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/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/permission#L379)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/permission#L379)
[/details]
----------------
@ -1633,7 +1628,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/php#L70)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/php#L70)
[/details]
----------------
@ -1647,7 +1642,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/php#L284)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/php#L284)
[/details]
----------------
@ -1666,7 +1661,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/php#L517)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/php#L517)
[/details]
----------------
@ -1686,7 +1681,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/php#L549)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/php#L549)
[/details]
----------------
@ -1719,7 +1714,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L18)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L18)
[/details]
----------------
@ -1737,7 +1732,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L39)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L39)
[/details]
----------------
@ -1755,7 +1750,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L64)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L64)
[/details]
----------------
@ -1776,7 +1771,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L135)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L135)
[/details]
----------------
@ -1794,7 +1789,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L168)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L168)
[/details]
----------------
@ -1812,7 +1807,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L190)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L190)
[/details]
----------------
@ -1834,7 +1829,7 @@ Requires YunoHost version 2.7.13 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L234)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L234)
[/details]
----------------
@ -1852,7 +1847,7 @@ Requires YunoHost version 2.7.13 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/postgresql#L265)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/postgresql#L265)
[/details]
----------------
@ -1873,7 +1868,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/setting#L10)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/setting#L10)
[/details]
----------------
@ -1892,7 +1887,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/setting#L36)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/setting#L36)
[/details]
----------------
@ -1910,7 +1905,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/setting#L62)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/setting#L62)
[/details]
----------------
@ -1930,7 +1925,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/setting#L123)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/setting#L123)
[/details]
----------------
@ -1951,7 +1946,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/setting#L145)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/setting#L145)
[/details]
----------------
@ -1976,7 +1971,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/string#L13)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/string#L13)
[/details]
----------------
@ -1998,7 +1993,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/string#L40)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/string#L40)
[/details]
----------------
@ -2020,7 +2015,7 @@ Requires YunoHost version 2.7.7 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/string#L71)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/string#L71)
[/details]
----------------
@ -2043,7 +2038,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/string#L103)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/string#L103)
[/details]
----------------
@ -2069,7 +2064,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/systemd#L15)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/systemd#L15)
[/details]
----------------
@ -2086,7 +2081,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/systemd#L38)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/systemd#L38)
[/details]
----------------
@ -2108,7 +2103,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/systemd#L67)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/systemd#L67)
[/details]
----------------
@ -2132,7 +2127,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L12)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L12)
[/details]
----------------
@ -2154,7 +2149,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L33)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L33)
[/details]
----------------
@ -2172,7 +2167,7 @@ Requires YunoHost version 2.4.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L53)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L53)
[/details]
----------------
@ -2191,7 +2186,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L64)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L64)
[/details]
----------------
@ -2210,7 +2205,7 @@ Requires YunoHost version 3.5.0.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L82)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L82)
[/details]
----------------
@ -2239,7 +2234,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L111)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L111)
[/details]
----------------
@ -2256,7 +2251,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L153)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L153)
[/details]
----------------
@ -2270,7 +2265,7 @@ Requires YunoHost version 4.1.7 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/user#L179)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/user#L179)
[/details]
----------------
@ -2291,7 +2286,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L61)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L61)
[/details]
----------------
@ -2383,7 +2378,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L154)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L154)
[/details]
----------------
@ -2409,7 +2404,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L399)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L404)
[/details]
----------------
@ -2467,7 +2462,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L483)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L488)
[/details]
----------------
@ -2479,6 +2474,7 @@ Requires YunoHost version 4.1.0 or higher.
**Arguments**:
- `-f`, `--file=`: the path to the file
- `-k`, `--key=`: the key to get
- `-a`, `--after=`: the line just before the key (in case of multiple lines with the name of the key in the file)
**Details**:<br/>
This helpers match several var affectation use case in several languages
@ -2511,7 +2507,7 @@ Requires YunoHost version 4.3 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L637)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L646)
[/details]
----------------
@ -2524,13 +2520,14 @@ Requires YunoHost version 4.3 or higher.
- `-f`, `--file=`: the path to the file
- `-k`, `--key=`: the key to set
- `-v`, `--value=`: the value to set
- `-a`, `--after=`: the line just before the key (in case of multiple lines with the name of the key in the file)
**Details**:<br/>
Requires YunoHost version 4.3 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L714)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L724)
[/details]
----------------
@ -2546,7 +2543,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L829)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L839)
[/details]
----------------
@ -2563,7 +2560,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L860)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L870)
[/details]
----------------
@ -2583,7 +2580,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L894)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L904)
[/details]
----------------
@ -2608,7 +2605,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L937)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L947)
[/details]
----------------
@ -2631,7 +2628,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L966)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L976)
[/details]
----------------
@ -2646,15 +2643,11 @@ Requires YunoHost version 3.5.0 or higher.
This helper should be used to avoid an upgrade of an app, or the upstream part
of it, when it's not needed
You can force an upgrade, even if the package is up to date, with the `--force` (or `-F`) argument :
```
sudo yunohost app upgrade <appname> --force
```
Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L991)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L997)
[/details]
----------------
@ -2686,7 +2679,7 @@ Requires YunoHost version 3.8.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/helpers/utils#L1021)
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/helpers/utils#L1027)
[/details]
----------------

29
pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md
View file

@ -7,7 +7,7 @@ routes:
default: '/packaging_apps_resources'
---
Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/4897f72974fff30b168a40bf55bf917395cca4cc/doc/generate_resource_doc.py) on 27/11/2023 (YunoHost version 11.2.7)
Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/c82787738753b361525c4ab88932914a1c260109/doc/generate_resource_doc.py) on 20/02/2024 (YunoHost version 11.2.10.1)
----------------
@ -280,18 +280,27 @@ Or more complex examples with several element, including one with asset that dep
Strictly speaking, this has nothing to do with the actual app install. `autoupdate` is expected to contain metadata for automatic maintenance / update of the app sources info in the manifest. It is meant to be a simpler replacement for "autoupdate" Github workflow mechanism.
The infos are used by this script : https://github.com/YunoHost/apps/blob/master/tools/autoupdate_app_sources/autoupdate_app_sources.py which is ran by the YunoHost infrastructure periodically and will create the corresponding pull request automatically.
The infos are used by this script : <https://github.com/YunoHost/apps/blob/master/tools/autoupdate_app_sources/autoupdate_app_sources.py> which is ran by the YunoHost infrastructure periodically and will create the corresponding pull request automatically.
The script will rely on the code repo specified in the upstream section of the manifest.
The script will rely on the code repo specified in `code` in the upstream section of the manifest.
`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
- 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.
The `autoupdate.strategy` is expected to be constructed like this: `latest_<gitforge>_<strategy>`
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.
You need to replace the `<gitforge>` in the strategy name by either `github`, `gitlab`, `gitea` or `forgejo`, as the autoupdater supports:
- GitHub
- GitLab (official and self-hosted instances)
- Gitea & Forgejo instances
And choose one strategy in the following ones:
- `latest_<gitforge>_release` : similar to `latest_<gitforge>_tag`, but starting from the list of releases. Note that it's the only strategy that provides the changelog link in the PR message. 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
- 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_<gitforge>_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_<gitforge>_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 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.
##### Provision/Update
- For elements with `prefetch = true`, will download the asset (for the appropriate architecture) and store them in `/var/cache/yunohost/download/$app/$source_id`, to be later picked up by `ynh_setup_source`. (NB: this only happens during install and upgrade, not restore)

6
pages/06.contribute/10.packaging_apps/packaging_apps_intro.fr.md
View file

@ -52,9 +52,9 @@ Divers outils ont été mis en place pour tester l'application et normaliser son
Après un certain temps, un ensemble de pratiques et de conventions communes a émergé et est en quelque sorte reflété et maintenu dans l'application modèle `example_ynh`. Bien qu'il soit tentant pour les développeurs de changer les schémas de nommage des variables ou de refactoriser la structure des scripts, il s'avère qu'il est encore plus important de s'en tenir à l'ensemble des pratiques communes (même si elles sont arbitraires et peu élégantes) pour faciliter la maintenance de toutes les applications par n'importe quel membre de la communauté du packaging à travers tous les dépôts !
Néanmoins, même si les aides existaient, la structure inhérente des applications était difficile et ennuyeuse à maintenir avec trop de morceaux de code redondants ou remplis de conventions historiques bizarres. **Un nouveau format v2** [a été conçu et ajouté à YunoHost 11.1 début 2023] (https://github.com/YunoHost/yunohost/pull/1289) dans l'espoir de moderniser et de simplifier l'emballage des applications et d'améliorer l'UI/UX de YunoHost.
Néanmoins, même si les aides existaient, la structure inhérente des applications était difficile et ennuyeuse à maintenir avec trop de morceaux de code redondants ou remplis de conventions historiques bizarres. **Un nouveau format v2** [a été conçu et ajouté à YunoHost 11.1 début 2023](https://github.com/YunoHost/yunohost/pull/1289) dans l'espoir de moderniser et de simplifier l'emballage des applications et d'améliorer l'UI/UX de YunoHost.
Cependant, [**un futur format v3** est encore à venir] (https://github.com/YunoHost/issues/issues/2136) pour simplifier davantage l'empaquetage des applications (comme la prise en charge des configurations NGINX/systemd/..., l'élimination du besoin d'écrire manuellement des scripts de suppression/sauvegarde/restauration, etc.)
Cependant, [**un futur format v3** est encore à venir](https://github.com/YunoHost/issues/issues/2136) pour simplifier davantage l'empaquetage des applications (comme la prise en charge des configurations NGINX/systemd/..., l'élimination du besoin d'écrire manuellement des scripts de suppression/sauvegarde/restauration, etc.)
## 4. Aperçu général de la structure d'une application YunoHost
@ -107,7 +107,7 @@ Grosso modo, l'installation proprement dite se compose généralement des opéra
## 5. Créer votre tout premier paquet YunoHost
A moins que vous ne souhaitiez vraiment partir de zéro ou de [`example_ynh`] (https://github.com/YunoHost/example_ynh), une pratique courante consiste à identifier une application similaire à celle que vous essayez d'empaqueter - typiquement parce qu'elle repose sur les mêmes technologies - à cloner le dépôt de code correspondant, et à adapter les différents fichiers.
A moins que vous ne souhaitiez vraiment partir de zéro ou de [`example_ynh`](https://github.com/YunoHost/example_ynh), une pratique courante consiste à identifier une application similaire à celle que vous essayez d'empaqueter - typiquement parce qu'elle repose sur les mêmes technologies - à cloner le dépôt de code correspondant, et à adapter les différents fichiers.
TODO/FIXME : here we should list a bunch of well-knowh apps for classic technologies