Mémo des commandes ¶
Mémo de quelques examples pour gérer son serveur Yunohost avec ligne de commande (CLI) via le terminal et une connexion SSH. Cela concerne principalement l’installation d’applications, les mises à jour (applications et système), et des opérations de maintenance basiques.
La commande
yunohostpeut être utilisée pour administrer votre serveur ou réaliser les mêmes actions que celles disponibles sur la webadmin. Elle doit être lancée (…) depuis l'utilisateur admin en précédant la commande desudo.1
Les commandes YNH sont structurées de la façon suivante :
yunohost app install <appName> --<optionName> <optionLabel>
^ ^ ^ ^
| | | |
catégorie action argument options
Global ¶
Connaitre la version de YNH installée
yunohost -v
Informations sur les commandes globales de YNH
yunohost -h
yunohost --help
Sur le même principe, avec l’option -h (ou --help, c’est la même chose), il est possible de demander des informations sur toutes les catégories disponibles, puis sur les actions disponibles pour une catégorie spécifique (dans cet exemple, la catégorie est user, et l’action create) :
yunohost user --help
yunohost user create --help
Applications ¶
Installer la version stable (branche « main »)
yunohost app install <appName>
Installer la version en cours de développement (branche « testing »)
yunohost app install <repoAdress>/<appName>/tree/testing --debug
Note – L’interface Web de YNH liste exclusivement les applications du dépôt officiel2 il est cependant toujours possible d’installer des applications d’un dépot tiers.
Installer une application à partir d’un dépot non-officiel
yunohost app install <repoAdress>/<appName>/ --debug
yunohost app install <repoAdress>/<appName>/tree/<branceName> --debug
Mises à jour ¶
Lister l’ensemble des mises à jour disponibles
yunohost tools update
Mettre à jour uniquement les composants du système
yunohost tools upgrade system
Mettre à jour toutes les applications
yunohost tools upgrade apps
Mettre a jour une application particulière
yunohost app upgrade <appName>
Utiliser la branche Testing
yunohost app upgrade <appName> -u <repoAdress>/<appName>/tree/testing --debug
Forcer une mise à jour
yunohost app upgrade <appName> --force
Maintenance ¶
Application : voir les différences avec la config par défaut
yunohost tools regen-conf --with-diff --dry-run <appName>
Application : rétablir la configuration par défaut
yunohost tools regen-conf <appName>
Serveur : libérer de l’espace sur le disque
yunohost tools basic-space-cleanup
Note – Cette commande opère un nettoyage partiel (apt, journalctl, logs, etc.). A utiliser lorsque le serveur en vient à manquer d’espace disque.