diff --git a/.markdownlint.json b/.markdownlint.json index 91f58666..38577c09 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -54,9 +54,10 @@ "code_blocks": false, "names": [ "YunoHost", - "Debian", "GitHub" ] }, - "line-length": false + "line-length": false, + "no-reversed-links": false, + "no-missing-space-atx": false } \ No newline at end of file diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.de.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.de.md index 2abdcfd6..9f60969a 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.de.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.de.md @@ -23,7 +23,7 @@ YunoHost ist ein **Betriebssystem**, das auf die einfachste Verwaltung eines **S - ![](image://icon-mail.png?resize=32&classes=inline) Enthält einen **vollständigen E-Mail-Stack** (Postfix, Dovecot, Rspamd, DKIM) ; - ![](image://icon-messaging.png?resize=32&classes=inline) … sowie **einen Instant Messaging Server** (XMPP) ; - ![](image://icon-lock.png?resize=32&classes=inline) Verwaltet **SSL-Zertifikate** (basierend auf Let's Encrypt) ; -- ![](image://icon-shield.png?resize=32&classes=inline) … und **Sicherheitssysteme** (fail2ban, yunohost-firewall) ; +- ![](image://icon-shield.png?resize=32&classes=inline) … und **Sicherheitssysteme** (`fail2ban`, `yunohost-firewall`) ; ## Ursprung diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.es.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.es.md index beaf8588..477a0e39 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.es.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.es.md @@ -23,7 +23,7 @@ YunoHost es un **sistema operativo** que persigue simplificar la administración - ![](image://icon-mail.png?resize=32&classes=inline) Incluye un **servidor de correo electrónico completo** (Postfix, Dovecot, Rspamd, DKIM) ; - ![](image://icon-messaging.png?resize=32&classes=inline) … así como un **servidor de mensajería instanea** (XMPP) ; - ![](image://icon-lock.png?resize=32&classes=inline) Administra **certificados SSL** (generados por Let's Encrypt) ; -- ![](image://icon-shield.png?resize=32&classes=inline) … y los **sistemas de seguridad** (fail2ban, yunohost-firewall) ; +- ![](image://icon-shield.png?resize=32&classes=inline) … y los **sistemas de seguridad** (`fail2ban`, `yunohost-firewall`) ; ## Origen diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md index 9454b64f..8d0bc6c7 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.fr.md @@ -23,7 +23,7 @@ YunoHost est un **système d’exploitation** qui vise à simplifier autant que - ![](image://icon-mail.png?resize=32&classes=inline) fourni avec un **serveur mail complet** (Postfix, Dovecot, Rspamd, DKIM) ; - ![](image://icon-messaging.png?resize=32&classes=inline) ... ainsi qu'un **serveur de messagerie instantanée** (XMPP) ; - ![](image://icon-lock.png?resize=32&classes=inline) gère les **certificats SSL** (basé sur Let's Encrypt) ; -- ![](image://icon-shield.png?resize=32&classes=inline) ... et des **systèmes de sécurité** (Fail2Ban, yunohost-firewall) ; +- ![](image://icon-shield.png?resize=32&classes=inline) ... et des **systèmes de sécurité** (`fail2ban`, `yunohost-firewall`) ; ## Origine diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md index 2c62052e..0106dee4 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.it.md @@ -23,7 +23,7 @@ YunoHost è un **sistema operativo** che mira a rendere il più semplice possibi - ![](image://icon-mail.png?resize=32&classes=inline) Include uno **stack di posta elettronica completo** (Postfix, Dovecot, Rspamd, DKIM); - ![](image://icon-messaging.png?resize=32&classes=inline)... e anche un **server di messaggistica istantanea** (XMPP); - ![](image://icon-lock.png?resize=32&classes=inline) Gestisce i **certificati SSL** (basati su Let's Encrypt) ; -- ![](image://icon-shield.png?resize=32&classes=inline)... e i **sistemi di sicurezza** (Fail2ban, yunohost-firewall); +- ![](image://icon-shield.png?resize=32&classes=inline)... e i **sistemi di sicurezza** (`fail2ban`, `yunohost-firewall`); ## Origine diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.md index ae77f095..f6c12314 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.md @@ -23,7 +23,7 @@ YunoHost is an **operating system** aiming for the simplest administration of a - ![](image://icon-mail.png?resize=32&classes=inline) Includes a **full e-mail stack** (Postfix, Dovecot, Rspamd, DKIM); - ![](image://icon-messaging.png?resize=32&classes=inline)... as well as **an instant messaging server** (XMPP); - ![](image://icon-lock.png?resize=32&classes=inline) Manages **SSL certificates** (based on Let's Encrypt) ; -- ![](image://icon-shield.png?resize=32&classes=inline)... and **security systems** (Fail2ban, yunohost-firewall); +- ![](image://icon-shield.png?resize=32&classes=inline)... and **security systems** (`fail2ban`, `yunohost-firewall`); ## Origin diff --git a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md index b29da551..b2312767 100644 --- a/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md +++ b/pages/01.overview/10.what_is_yunohost/what_is_yunohost.ru.md @@ -23,7 +23,7 @@ YunoHost это **операционная система** позволяюща - ![](image://icon-mail.png?resize=32&classes=inline) Включает **полный набор для работы электронной почты** (Postfix, Dovecot, Rspamd, DKIM); - ![](image://icon-messaging.png?resize=32&classes=inline)... более известный как **встроенный сервер сообщений** (XMPP); - ![](image://icon-lock.png?resize=32&classes=inline) Управляй **SSL сертификатами** (Основано на Let's Encrypt) ; -- ![](image://icon-shield.png?resize=32&classes=inline)... и **системами безопасности** (Fail2ban, yunohost-firewall); +- ![](image://icon-shield.png?resize=32&classes=inline)... и **системами безопасности** (`fail2ban`, `yunohost-firewall`); ## История diff --git a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.de.md b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.de.md index d3785a60..001569bd 100644 --- a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.de.md +++ b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.de.md @@ -48,8 +48,8 @@ Bildschirm auf den Server anschliessen, sich einloggen und diesen Befehl eingebe Die Standard-Anmeldedaten (vor der Nachinstallation!) zum Einloggen sind: -- login: root -- password: yunohost +- login: `root` +- password: `yunohost` (Wenn Sie ein rohes Armbian-Image anstelle des vorinstallierten YunoHost-Images verwenden, lauten die Anmeldedatenen root / 1234) diff --git a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.fr.md b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.fr.md index 361dbcd2..426a945e 100644 --- a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.fr.md +++ b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.fr.md @@ -48,8 +48,8 @@ Branchez un écran sur votre serveur, loggez-vous et tapez `hostname --all-ip-ad Les identifiants par défaut (avant la post-installation!) sont : -- login : root -- mot de passe : yunohost +- login : `root` +- mot de passe : `yunohost` (Si vous utilisez une image Armbian brute plutôt que les images YunoHost pré-installées, les identifiants sont root / 1234) diff --git a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.md b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.md index 123fb34e..89c5ef23 100644 --- a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.md +++ b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.md @@ -48,8 +48,8 @@ Plug a screen on your server, log in and type `hostname --all-ip-address`. The default credentials (before post-installation!) to log in are: -- login: root -- password: yunohost +- login: `root` +- password: `yunohost` (If you are using a raw Armbian image instead of the pre-installed YunoHost image, the credentials are root / 1234) diff --git a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md index 4576fe44..6191aca4 100644 --- a/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md +++ b/pages/02.administer/10.install/10.finding_the_local_ip/finding_the_local_ip.ru.md @@ -48,8 +48,8 @@ routes: Учетные данные по умолчанию (перед постустановкой!) для входа в систему: -- логин: root -- пароль: yunohost +- логин: `root` +- пароль: `yunohost` (Если вы используете необработанный образ Armbian вместо предустановленного образа YunoHost, учетные данные - root / 1234) diff --git a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.de.md b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.de.md index abe7f8b1..b3b0e5fc 100644 --- a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.de.md +++ b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.de.md @@ -25,6 +25,7 @@ Ihre Box/Router-Administrationsoberfläche ist in der Regel erreichbar über [ht ### 2. Die lokale IP Ihres Servers finden Identifizieren Sie die lokale IP Ihres Servers, entweder : + - von Ihrer Box/Router-Schnittstelle, die möglicherweise angeschlossene Geräte auflistet - über die YunoHost-Schnittstelle, Abschnitt "Internetkonnektivität", dann auf "Details" im IPv4-Bericht klicken. - von der Befehlszeile Ihres Servers aus, indem Sie `hostname -I` ausführen @@ -39,12 +40,13 @@ Suchen Sie in der Verwaltungsoberfläche Ihres Routers nach etwas wie "Router-Ko Das Öffnen der unten aufgeführten Ports ist notwendig, damit die verschiedenen in YunoHost verfügbaren Dienste funktionieren. Für jeden von ihnen wird die 'TCP'-Weiterleitung benötigt. Einige Schnittstellen beziehen sich auf 'externe' und 'interne' Ports : diese sind in unserem Fall gleich. -* Web: 80 (HTTP), 443 (HTTPS) -* [SSH](/ssh): 22 -* [XMPP](/XMPP): 5222 (clients), 5269 (servers) -* [Email](/email): 25, 587 (SMTP), 993 (IMAP) +- Web: 80 (HTTP), 443 (HTTPS) +- [SSH](/ssh): 22 +- [XMPP](/XMPP): 5222 (clients), 5269 (servers) +- [Email](/email): 25, 587 (SMTP), 993 (IMAP) Wenn Sie sowohl ein Modem als auch einen Router verwenden, dann müssen Sie Folgendes tun: + 1. zuerst auf dem Modem (der Box, die dem Internet am nächsten ist) Regeln erstellen, um die oben genannten Ports an Ihren Router weiterzuleiten; 2. dann auf dem Router (der Box zwischen dem Modem und Ihren Geräten) Regeln erstellen, um die oben genannten Ports an die statische IP-Adresse für Ihren Server weiterzuleiten. diff --git a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.es.md b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.es.md index e8fc229b..3ca194da 100644 --- a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.es.md +++ b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.es.md @@ -19,18 +19,19 @@ El esquema aquí abajo intenta explicar brevemente el rol de la redirección de ### 0. Diagnosticar los puertos abiertos -Una vez que tienes la redirección configurada, deberías poder comprobar que los puertos están bien abiertos con esta herramienta : +Una vez que tienes la redirección configurada, deberías poder comprobar que los puertos están bien abiertos con esta herramienta : -Comprobar la redirección de los puertos +Comprobar la redirección de los puertos ### 1. Acceder a la interfaz de administración de tu router/caja/box -En general la interfaz de administración está accesible desde http://192.168.0.1 o http://192.168.1.1. +En general la interfaz de administración está accesible desde o . Luego, es posible que tengas que autenticarte con los ID provechos pour tu proveedor de acceso a Internet. ### 2. Descubrir la IP local del servidor Identifica cuál es la IP local de tu servidor, o sea : + - desde la interfaz de tu router/caja/box, donde tal vez estén listados los dipositivos conectados a la red local - desde la webadmin de YunoHost, en 'Estado del servidor', 'Red' - desde la línea de comandos en tu servidor, por ejemplo con `ip a | grep "scope global" | awk '{print $2}'` @@ -43,10 +44,10 @@ En la interfaz de administración de tu router/caja/box, tienes que encontrar un Luego tienes que redirigir cada uno de los puertos listados a continuación hacia la IP local de tu router para que los varios servicios de YunoHost funcionen. Para cada uno de ellos, una redirección 'TCP' es necesaria. En algunas interfaces, tal vez encontrarás referencias a un puerto 'externo' y un puerto 'interno' : en nuestro caso, se trata del mismo número de puerto, que sea interno o externo. -* Web: 80 (HTTP), 443 (HTTPS) -* [SSH](/ssh): 22 -* [XMPP](/XMPP): 5222 (clients), 5269 (servers) -* [Email](/email): 25, 587 (SMTP), 993 (IMAP) +- Web: 80 (HTTP), 443 (HTTPS) +- [SSH](/ssh): 22 +- [XMPP](/XMPP): 5222 (clients), 5269 (servers) +- [Email](/email): 25, 587 (SMTP), 993 (IMAP) ! [fa=exclamation-triangle /] Algunos proveedores de acceso a Internet bloquean el puerto 25 (mail SMTP) por defecto para luchar con el spam. Otros (más escasos) no permiten utilizar libremente los puertos 80/443. Dependiendo de tu proveedor, puede ser posible de abrir estos puertos en la interfaz... Ver [esta página](/isp) por más informaciones. @@ -54,8 +55,6 @@ Luego tienes que redirigir cada uno de los puertos listados a continuación haci Una tecnología llamada UPnP está disponible en algunos routers/cajas/box y permite redirigir automáticamente puertos hacia una máquina que lo pide. Si UPnP está activado en tu casa, ejecutar este comando debería automáticamente redirigir los puertos correctos : - ```bash sudo yunohost firewall reload ``` - diff --git a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.fr.md b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.fr.md index 4ab88031..61d7c75c 100644 --- a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.fr.md +++ b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.fr.md @@ -22,13 +22,14 @@ YunoHost 3.8 vous permettra de vérifier si les ports sont correctement exposés ### 2. Accéder à l'interface d'administration de votre box/routeur -L'interface d'administration est généralement accessible via http://192.168.0.1 ou http://192.168.1.1. +L'interface d'administration est généralement accessible via ou . Ensuite, il vous faudra peut-être vous authentifier avec les identifiants fournis par votre fournisseur d'accès à Internet (FAI). ### 3. Trouver l'IP locale de votre serveur Identifiez quelle est l'IP locale de votre serveur, soit : + - depuis l'interface de votre routeur/box, qui liste peut-être les dispositifs connectés; - depuis la webadmin de YunoHost, dans 'Diagnostic', section 'Connectivité Internet', cliquer sur 'Détails' à côté de la ligne sur IPv4. @@ -44,10 +45,10 @@ nom diffère suivant le type / marque de la box... Il vous faut ensuite rediriger chacun des ports listés ci-dessous vers l'IP locale de votre serveur pour que les différents services de YunoHost fonctionnent. Pour chacun d'eux, une redirection 'TCP' est nécessaire. Certaines interfaces font référence à un port « externe » et un port « interne » : dans notre cas il s'agit du même. -* Web: 80 (HTTP), 443 (HTTPS) -* [SSH](/ssh): 22 -* [XMPP](/XMPP): 5222 (clients), 5269 (serveurs) -* [Email](/email): 25, 587 (SMTP), 993 (IMAP) +- Web: 80 (HTTP), 443 (HTTPS) +- [SSH](/ssh): 22 +- [XMPP](/XMPP): 5222 (clients), 5269 (serveurs) +- [Email](/email): 25, 587 (SMTP), 993 (IMAP) ! [fa=exclamation-triangle /] Certains fournisseurs d'accès à Internet bloquent le port 25 (mail SMTP) par défaut pour combattre le spam. D'autres (plus rares) ne permettent pas d'utiliser librement les ports 80/443. En fonction de votre FAI, il peut être possible d'ouvrir ces ports dans l'interface... Voir [cette page](/isp) pour plus d'informations. diff --git a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.md b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.md index 9b64dfd7..71d627d2 100644 --- a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.md +++ b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.md @@ -25,6 +25,7 @@ Your box/router admin interface is usually reachable via [http://192.168.0.1](ht ### 2. Find the local IP of your server Identify what is thei *local* IP of your server, either : + - from your box/router interface, which might list devices connected - from the YunoHost webadmin, in 'Diagnosis', section 'Internet connectivity', click on 'Details' on the IPv4 report. - from the command line in your server, by running `hostname -I` @@ -39,12 +40,13 @@ In your router admin interface, look for something like 'router configuration' o Opening the ports listed below is necessary for the various services available in YunoHost to work. For each of them, the 'TCP' forwarding is needed. Some interfaces refer to 'external' and 'internal' ports : these are the same in our case. -* Web: 80 (HTTP), 443 (HTTPS) -* [SSH](/ssh): 22 -* [XMPP](/XMPP): 5222 (clients), 5269 (servers) -* [Email](/email): 25, 587 (SMTP), 993 (IMAP) +- Web: 80 (HTTP), 443 (HTTPS) +- [SSH](/ssh): 22 +- [XMPP](/XMPP): 5222 (clients), 5269 (servers) +- [Email](/email): 25, 587 (SMTP), 993 (IMAP) If you use both a modem and a router, then you need to do the following: + 1. first on the modem (the box closest to the internet) create rules to forward the above ports to your router; 2. then on the router (the box between the modem and your devices) create rules to forward the above ports to the static IP address for your server. @@ -57,4 +59,3 @@ A technology called UPnP is available on some internet boxes / routers and allow ```bash sudo yunohost firewall reload ``` - diff --git a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md index 10390dcb..46d2b5f5 100644 --- a/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md +++ b/pages/02.administer/10.install/15.isp_box_config/isp_box_config.ru.md @@ -24,6 +24,7 @@ routes: ### 2. Найдите локальный IP-адрес вашего сервера Определите, каков *локальный* IP вашего сервера, либо : + - из вашего интерфейса box / router, в котором может быть список подключенных устройств - в веб-администраторе YunoHost, в разделе "Диагностика", "Подключение к Интернету", нажмите "Подробности" в отчете IPv4. - из командной строки на вашем сервере, запустив `hostname -I` @@ -38,12 +39,13 @@ routes: Открытие перечисленных ниже портов необходимо для работы различных сервисов, доступных в YunoHost. Для каждого из них необходима переадресация "TCP". Некоторые интерфейсы относятся к "внешним" и "внутренним" портам: в нашем случае это одно и то же. -* Веб: 80 (HTTP), 443 (HTTPS) -* [SSH](/ssh): 22 -* [XMPP](/XMPP): 5222 (клиенты), 5269 (серверы) -* [Почтовые](/email): 25, 587 (SMTP), 993 (IMAP) +- Веб: 80 (HTTP), 443 (HTTPS) +- [SSH](/ssh): 22 +- [XMPP](/XMPP): 5222 (клиенты), 5269 (серверы) +- [Почтовые](/email): 25, 587 (SMTP), 993 (IMAP) Если вы используете и модем, и маршрутизатор, то вам необходимо выполнить следующее: + 1. сначала на модеме (поле, расположенном ближе всего к Интернету) создайте правила для перенаправления вышеуказанных портов на ваш маршрутизатор; 2. затем на маршрутизаторе (поле между модемом и вашими устройствами) создайте правила для пересылки вышеуказанных портов на статический IP-адрес вашего сервера. @@ -56,4 +58,3 @@ routes: ```bash sudo yunohost firewall reload ``` - diff --git a/pages/02.administer/10.install/20.dns_config/dns_config.de.md b/pages/02.administer/10.install/20.dns_config/dns_config.de.md index 56e683b8..7a41fc2b 100644 --- a/pages/02.administer/10.install/20.dns_config/dns_config.de.md +++ b/pages/02.administer/10.install/20.dns_config/dns_config.de.md @@ -18,7 +18,7 @@ Domain über die Schnittstelle Ihres Registrars konfigurieren. ## Empfohlene DNS-Konfiguration -_N.B. : Die Beispiele hier verwenden den Text: `your.domain.tld`, der durch Ihre eigene Domain (z. B.`www.yunohost.org`) zu ersetzen ist._ +*N.B. : Die Beispiele hier verwenden den Text: `your.domain.tld`, der durch Ihre eigene Domain (z. B.`www.yunohost.org`) zu ersetzen ist.* YunoHost bietet eine empfohlene DNS-Konfiguration, die auf zwei Arten zugänglich ist : @@ -81,7 +81,7 @@ dargestellt wird: | TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=irgendeingrooßerSchlüssel"` | | TXT | _dmarc | `"v=DMARC1; p=none"` | -#### Einige Hinweise zu dieser Tabelle +### Einige Hinweise zu dieser Tabelle - Nicht alle dieser Aufzeichnungen sind notwendig. Für eine Minimalinstallation werden nur die fett gedruckten Datensätze benötigt; - Der Punkt am Ende `your.domain.tld.` ist wichtig ;) ; @@ -103,8 +103,8 @@ Das heißt, wenn Ihre öffentliche IPv4-Adresse `111.222.333.444` ist und Ihr Domänename `domain.tld` ist, sollten Sie mit dem Befehl `nslookup` das folgende Ergebnis erhalten : -```shell -$ nslookup 111.222.333.444 +```bash +nslookup 111.222.333.444 444.333.222.111.in-addr.arpa name = domain.tld. ``` diff --git a/pages/02.administer/10.install/20.dns_config/dns_config.es.md b/pages/02.administer/10.install/20.dns_config/dns_config.es.md index 306e805d..7985d260 100644 --- a/pages/02.administer/10.install/20.dns_config/dns_config.es.md +++ b/pages/02.administer/10.install/20.dns_config/dns_config.es.md @@ -15,7 +15,7 @@ Si utilizas un [dominio automático](/dns_nohost_me) provecho por el Proyecto Yu ## Configuración DNS recomendada -_Nota: los ejemplos utilizan el marcador `tu.dominio.tld`, debe ser reemplazado por su propio dominio, como `www.yunohost.org`._ +*Nota: los ejemplos utilizan el marcador `tu.dominio.tld`, debe ser reemplazado por su propio dominio, como `www.yunohost.org`.* YunoHost provee una configuración DNS recomendada, accesible vía : @@ -75,7 +75,7 @@ Pero puede ser un poco más fácil entenderla viéndola de esta manera : | TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=uneGrannnndeClef"` | | TXT | _dmarc | `"v=DMARC1; p=none"` | -#### Algunas notas a propósito de esta tabla +### Algunas notas a propósito de esta tabla - Todos los registros no son necesarios. Para una instalación mínima, solos los registros en negrita son necesarios. - El punto al final de `tu.dominio.tld.` es importante ;) ; diff --git a/pages/02.administer/10.install/20.dns_config/dns_config.fr.md b/pages/02.administer/10.install/20.dns_config/dns_config.fr.md index 0ee5b2de..ad959694 100644 --- a/pages/02.administer/10.install/20.dns_config/dns_config.fr.md +++ b/pages/02.administer/10.install/20.dns_config/dns_config.fr.md @@ -23,7 +23,7 @@ domaine via l'interface de votre registrar. ## Configuration DNS recommandée -_NB : les exemples utilisent ici le texte `votre.domaine.tld`, à remplacer par votre propre domaine (par exemple `www.yunohost.org`)._ +*NB : les exemples utilisent ici le texte `votre.domaine.tld`, à remplacer par votre propre domaine (par exemple `www.yunohost.org`).* YunoHost fournit une configuration DNS recommandée, accessible via : @@ -86,7 +86,7 @@ suivante : | TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=uneGrannnndeClef"` | | TXT | _dmarc | `"v=DMARC1; p=none"` | -#### Quelques notes à propos de cette table +### Quelques notes à propos de cette table - Tous ces enregistrements ne sont pas nécessaires. Pour une installation minimale, seuls les enregistrements en gras sont nécessaires ; - Le point à la fin de `votre.domaine.tld.` est important ;) ; @@ -110,8 +110,8 @@ Cela signifie que si votre adresse IPv4 publique est `111.222.333.444` et que votre nom de domaine est `domain.tld`, vous devez obtenir le résultat suivant en utilisant la commande `nslookup` : -```shell -$ nslookup 111.222.333.444 +```bash +nslookup 111.222.333.444 444.333.222.111.in-addr.arpa name = domain.tld. ``` diff --git a/pages/02.administer/10.install/20.dns_config/dns_config.md b/pages/02.administer/10.install/20.dns_config/dns_config.md index 0279d27d..08e6f01d 100644 --- a/pages/02.administer/10.install/20.dns_config/dns_config.md +++ b/pages/02.administer/10.install/20.dns_config/dns_config.md @@ -83,7 +83,7 @@ Though it might be easier to understand it if displayed like this: | TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"` | | TXT | _dmarc | `"v=DMARC1; p=none"` | -#### A few notes about this table +### A few notes about this table - Not all these lines are absolutely necessary. For a minimal setup, you only need the records in bold. - The dot at the end of `your.domain.tld.` is important ;); @@ -106,8 +106,8 @@ If your public IPv4 address is `111.222.333.444` and your DNS domain is `domain.tld`, you should get following answer when using `nslookup` command tool: -```shell -$ nslookup 111.222.333.444 +```bash +nslookup 111.222.333.444 444.333.222.111.in-addr.arpa name = domain.tld. ``` diff --git a/pages/02.administer/10.install/20.dns_config/dns_config.ru.md b/pages/02.administer/10.install/20.dns_config/dns_config.ru.md index b06b6bb1..50d786c2 100644 --- a/pages/02.administer/10.install/20.dns_config/dns_config.ru.md +++ b/pages/02.administer/10.install/20.dns_config/dns_config.ru.md @@ -83,7 +83,7 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none" | TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"` | | TXT | _dmarc | `"v=DMARC1; p=none"` | -#### Несколько замечаний по поводу этой таблицы +### Несколько замечаний по поводу этой таблицы - Не все эти строки абсолютно необходимы. Для минимальной настройки вам понадобятся только записи, выделенные жирным шрифтом. - Точка в конце `ваш.домен.tld.` важна ;); @@ -106,8 +106,8 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none" -домен - `domain.tld`, вы должны получить следующий ответ при использовании командной строки `nslookup`: -```shell -$ nslookup 111.222.333.444 +```bash +nslookup 111.222.333.444 444.333.222.111.in-addr.arpa name = domain.tld. ``` diff --git a/pages/02.administer/10.install/25.installing_debian/installing_debian.md b/pages/02.administer/10.install/25.installing_debian/installing_debian.md index e23af2e9..75ae05a2 100644 --- a/pages/02.administer/10.install/25.installing_debian/installing_debian.md +++ b/pages/02.administer/10.install/25.installing_debian/installing_debian.md @@ -7,31 +7,31 @@ routes: default: '/installing_debian' --- -If you can't install Yunohost successfully, there's always the option to install Debian and then install Yunohost on top. +If you can't install YunoHost successfully, there's always the option to install Debian and then install YunoHost on top. ## Which Debian version -At the time of writing, only Debian 11 is supported by Yunohost. Don't use Debian 12. +At the time of writing, only Debian 11 is supported by YunoHost. Don't use Debian 12. ## Before you start -The Debian installer isn't the easiest Linux installer, especially for beginners. It'll be easier to **format the hard drive** you plan to use for Debian+Yunohost **before you install Debian**, using your disk utility of choice. +The Debian installer isn't the easiest Linux installer, especially for beginners. It'll be easier to **format the hard drive** you plan to use for Debian+YunoHost **before you install Debian**, using your disk utility of choice. ## Installing Debian ### Booting the installer -This guide won't go into details on how to boot the Debian installer. You can use Debian's own documentation for that. The short version is you'll need to flash a USB stick with the Debian 11 image, like you would flash the Yunohost image. +This guide won't go into details on how to boot the Debian installer. You can use Debian's own documentation for that. The short version is you'll need to flash a USB stick with the Debian 11 image, like you would flash the YunoHost image. ### Installing In general, you can simply follow the instructions on screen and use the suggested defaults. -Debian installer will ask for a **hostname** and a **domain name**. You can use “yunohost” and “yunohost.local”. It’s not really important since the Yunohost Installer will overwrite those anyway. +Debian installer will ask for a **hostname** and a **domain name**. You can use “YunoHost” and “YunoHost.local”. It’s not really important since the YunoHost Installer will overwrite those anyway. Debian will ask for a **root password**. Make sure you pick a **really long and complex** one and save it to your password manager of choice (Bitwarden, Firefox, etc…) or write it somewhere safe. Remember that this is a server that will be available on the internet, making it vulnerable to possible attacks so you should be extra safe here! -The installer will also ask for a **user account** and another password. **Important:** name it something that won’t be used by your Yunohost server later. For example, you can name it `debian`. Be sure to also use a long complex password. +The installer will also ask for a **user account** and another password. **Important:** name it something that won’t be used by your YunoHost server later. For example, you can name it `debian`. Be sure to also use a long complex password. When the install asks about where to install and how to **create disk partitions**, select the option to use the whole disk, unless you know what you're doing. @@ -51,5 +51,5 @@ The installer will ask about which **desktop environment** you want. You should 2. Reboot 3. Login as `root` with the long complex password you created earlier. 4. Install curl by typing `apt install curl` -5. Proceed to install Yunohost on Debian using these instructions: +5. Proceed to install YunoHost on Debian using these instructions: - The installer will ask for permission to overwrite some configuration files. Select Yes. diff --git a/pages/02.administer/10.install/install.de.md b/pages/02.administer/10.install/install.de.md index 4ffdfcb3..6adc58d2 100644 --- a/pages/02.administer/10.install/install.de.md +++ b/pages/02.administer/10.install/install.de.md @@ -132,57 +132,55 @@ Wähle die Hardware, auf der du YunoHost installieren willst : [/div] - {% if hardware != '' %} {% if wsl %} !! Dieses Setup ist vorwiegend für lokales Testing durch fortgeschrittene Benutzer gedacht. Aufgrund Limitierungen auf WSL Seite (insbesondere veränderliche IP Adresse), selfhosting kann damit knifflig sein und wird hier nicht weiter beschrieben. {% endif %} - ## [fa=list-alt /] Pre-requisites {% if regular %} -* Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum) +- Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum) {% elseif rpi34 %} -* Ein Raspberry Pi 3 oder 4 +- Ein Raspberry Pi 3 oder 4 {% elseif rpi012 %} -* Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM +- Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM {% elseif internetcube %} -* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 -* Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei +- Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 +- Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei {% elseif arm_sup %} -* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 +- Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 {% elseif arm_unsup %} -* Ein ARM Board mit mindestens 512MB RAM +- Ein ARM Board mit mindestens 512MB RAM {% elseif vps_debian %} -* Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) (mit **kernel >= 3.12**) vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum) +- Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) (mit **kernel >= 3.12**) vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum) {% elseif vps_ynh %} -* Ein dedizierter oder Virtual Private Server mit YunoHost vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum) +- Ein dedizierter oder Virtual Private Server mit YunoHost vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum) {% elseif virtualbox %} -* Ein x86 Computer mit [VirtualBox installiert](https://www.virtualbox.org/wiki/Downloads) und ausreichend Arbeitsspeicherkapazität (RAM), um eine kleine virtuelle Maschine mit 1024MB RAM und 8GB Speicherkapazität (Minimum) betreiben zu können +- Ein x86 Computer mit [VirtualBox installiert](https://www.virtualbox.org/wiki/Downloads) und ausreichend Arbeitsspeicherkapazität (RAM), um eine kleine virtuelle Maschine mit 1024MB RAM und 8GB Speicherkapazität (Minimum) betreiben zu können {% endif %} {% if arm %} -* Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board; -* Eine microSD Karte: 16GB Speicherkapazität (Minimum), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) nachdrücklich empfohlen (so wie [diese SanDisk A1 Karte](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)); +- Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board; +- Eine microSD Karte: 16GB Speicherkapazität (Minimum), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) nachdrücklich empfohlen (so wie [diese SanDisk A1 Karte](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)); {% endif %} {% if regular %} -* Ein USB Stick mit mindestens 1GB Speicherkapazität ODER einem Standard CD-Rohling +- Ein USB Stick mit mindestens 1GB Speicherkapazität ODER einem Standard CD-Rohling {% endif %} {% if wsl %} -* Windows 10 und neuer -* Administrator Rechte -* Windows Subsystem for Linux, aus dem Optional Features Menü von Windows installiert -* *Empfohlen:* Windows Command Prompt App, aus dem Microsoft Store installiert. Viel besser als der Standard Terminal, weil sie Shortcuts für WSL distros bietet. +- Windows 10 und neuer +- Administrator Rechte +- Windows Subsystem for Linux, aus dem Optional Features Menü von Windows installiert +- *Empfohlen:* Windows Command Prompt App, aus dem Microsoft Store installiert. Viel besser als der Standard Terminal, weil sie Shortcuts für WSL distros bietet. {% endif %} {% if at_home %} -* Ein [vernünftiger ISP](/isp), vorzugsweise mit einer guten und unbegrenzten Upstream Bandbreite +- Ein [vernünftiger ISP](/isp), vorzugsweise mit einer guten und unbegrenzten Upstream Bandbreite {% if not virtualbox %} -* Ein Ethernet Kabel (RJ-45), um deinen Server mit deinem Router zu verbinden. {% if rpi012 %} (Oder, für Rasperry Pi Zero : und USB OTG oder ein Wifi Dongle) {% endif %} +- Ein Ethernet Kabel (RJ-45), um deinen Server mit deinem Router zu verbinden. {% if rpi012 %} (Oder, für Rasperry Pi Zero : und USB OTG oder ein Wifi Dongle) {% endif %} {% endif %} -* Ein Computer, um diese Anleitung zu lesen, das Image zu flashen und auf deinen Server zuzugreifen. +- Ein Computer, um diese Anleitung zu lesen, das Image zu flashen und auf deinen Server zuzugreifen. {% else %} -* Ein Computer oder ein Smartphone, um diese Anleitung zu lesen und auf deinen Server zuzugreifen. +- Ein Computer oder ein Smartphone, um diese Anleitung zu lesen und auf deinen Server zuzugreifen. {% endif %} {% if virtualbox %} @@ -190,7 +188,9 @@ Wähle die Hardware, auf der du YunoHost installieren willst : {% endif %} {% if wsl %} + ## Vorstellung + WSL ist ein cooles Windows 10 Feature, das Linux pseudo-Distributionen durch die Kommandozeile verfügbar macht. Lass es uns pseudo nennen, weil auch obwohl sie nicht wirklich wie virtuelle Maschinen sind, sind sie auf Virtualisierungskapazitäten angewiesen, die deren Integration mit Windows fast nahtlos machen. So kann z.B. Docker für Windows jetzt auf WSL bauen, anstatt auf Hyper-V. @@ -216,7 +216,7 @@ rmdir .\debian -R Nun kannst du darauf zugreifen: Führe `wsl.exe -d YunoHost` aus. -Da es Debian 9 Stretch ist, lass uns ein Upgrade auf Debian 11 Bullseye machen: +Da es Debian 9 Stretch ist, lass uns ein Upgrade auf Debian 11 Bullseye machen: ```bash # In WSL @@ -225,6 +225,7 @@ sudo apt update sudo apt upgrade sudo apt dist-upgrade ``` + ## Verhindern, dass WSL an Konfigurationsdateien herumfeilt Bearbeite `/etc/wsl.conf` und füge den folgenden Code darin ein: @@ -252,6 +253,7 @@ Unter WSL fehlt Debian `systemd`, eine Service-Konfigurations-Software. Diese ist ein Schlüsselelement für YunoHost, und für jede anständige Debian Distro (also ernsthaft Microsoft, was zum Henker). Lass es uns installieren: 1. Installation der dotNET Runtime: + ```bash # In WSL wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb @@ -263,6 +265,7 @@ sudo apt install -y dotnet-sdk-3.1 ``` 2. Installation von [Genie](https://github.com/arkane-systems/genie): + ```bash # In WSL # Das repository hinzufügen @@ -291,8 +294,10 @@ Rufe `genie -s` immer während des Startes deiner Distro auf. `wsl -d YunoHost -e genie -s` -## Backup und Wiederherstellung der Distro +## Backup und Wiederherstellung der Distro + ### Mache dein erstes Distro Backup + Wie zuvor gesagt, gibt es keine Rollback Möglichkeit. Lass uns deshal deine frische Distro exportieren. In PowerShell: ``` @@ -307,10 +312,11 @@ cd ~ wsl --unregister YunoHost wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 ``` + {% endif %} - {% if vps_ynh %} + ## YunoHost VPS Provider Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen : @@ -329,8 +335,8 @@ Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen : [/div] {% endif %} - {% if at_home %} + ## [fa=download /] Lade das {{image_type}} Image herunter {% if rpi012 %} @@ -396,7 +402,7 @@ $(document).ready(function () { .replace('%7Bimage%7D', infos.image) .replace('{image}', infos.image) .replace('{version}', infos.version); - + if (!infos.file.startsWith("http")) infos.file="https://build.yunohost.org/"+infos.file; html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); @@ -413,17 +419,16 @@ $(document).ready(function () { }); - - - - - {% if not virtualbox %} {% if arm %} + ## ![microSD Karte mit Adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash das {{image_type}} Image + {% else %} + ## ![USB Stick](image://usb_key.png?resize=100,100&class=inline) Flash das YunoHost Image + {% endif %} Jetzt wo du das Image von {{image_type}} heruntergeladen hast, solltest du es auf {% if arm %}einer microSD Karte{% else %}einem USB stick oder einer CD/DVD flashen.{% endif %} @@ -457,16 +462,17 @@ Führe dann Folgendes aus : # Ersetze /dev/mmcblk0 durch das richtige Device, wenn der Name deines Device anders ist... dd if=/path/to/yunohost.img of=/dev/mmcblk0 ``` + [/ui-tab] {% if regular %} [ui-tab title="Eine CD/DVD brennen"] Für ältere Geräte könntest du eine CD/DVD brennen wollen. Die zu verwendende Software hängt von deinem Betriebssystem ab. -* Auf Windows, benutze [ImgBurn](http://www.imgburn.com/), um die Image Datei auf die Disc zu schreiben. +- Auf Windows, benutze [ImgBurn](http://www.imgburn.com/), um die Image Datei auf die Disc zu schreiben. -* Auf macOS, benutze [Disk Utility](http://support.apple.com/kb/ph7025) +- Auf macOS, benutze [Disk Utility](http://support.apple.com/kb/ph7025) -* Auf GNU/Linux hat man eine große Auswahl, wie [Brasero](https://wiki.gnome.org/Apps/Brasero) oder [K3b](http://www.k3b.org/) +- Auf GNU/Linux hat man eine große Auswahl, wie [Brasero](https://wiki.gnome.org/Apps/Brasero) oder [K3b](http://www.k3b.org/) [/ui-tab] {% endif %} [/ui-tabs] @@ -485,34 +491,28 @@ Für ältere Geräte könntest du eine CD/DVD brennen wollen. Die zu verwendende Gehe zu **Settings** > **Network**: -* Wähle `Bridged adapter` -* Wähle den Namen deines Interface: +- Wähle `Bridged adapter` +- Wähle den Namen deines Interface: **wlan0**, wenn du kabellos verbunden bist, oder andernfalls **eth0**. ![](image://virtualbox_2.png?class=inline) {% endif %} - - - - - - - - {% if arm %} + ## [fa=plug /] Das Board einschalten -* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). - * Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen. -* Stecke die SD Karte in dein Board. -* (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst. -* Schalte das Board ein. -* Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert. -* Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server. +- Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). + - Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen. +- Stecke die SD Karte in dein Board. +- (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst. +- Schalte das Board ein. +- Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert. +- Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server. {% elseif virtualbox %} + ## [fa=plug /] Die virtuelle Maschine hochfahren Starte die virtuelle Maschine nach der Auswahl des YunoHost Image. @@ -521,17 +521,18 @@ Starte die virtuelle Maschine nach der Auswahl des YunoHost Image. ! Wenn du an den Fehler "VT-x ist nicht erreichbar" gerätst, musst du wahrscheinlich Virtualisierung im BIOS deines Computers einschalten. - {% else %} + ## [fa=plug /] Die Maschine von deinem USB Stick booten -* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). -* Fahre deinen Server mit dem USB Stick oder einer eingesteckten CD-ROM hoch und wähle es durch Drücken einer der folgenden (Hardware spezifischen) Tasten als **bootable device** aus: +- Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). +- Fahre deinen Server mit dem USB Stick oder einer eingesteckten CD-ROM hoch und wähle es durch Drücken einer der folgenden (Hardware spezifischen) Tasten als **bootable device** aus: ``, ``, ``, ``, `` oder ``. - * Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden. + - Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden. {% endif %} {% if regular or virtualbox %} + ## [fa=rocket /] Die grafische Installation starten Du solltest einen Bildschirm wie diesen sehen: @@ -554,9 +555,10 @@ Du solltest einen Bildschirm wie diesen sehen: Das YunoHost-Projekt hat die klassische Installation so weit wie möglich vereinfacht, damit sich möglichst viele Menschen nicht in zu technischen oder fallbezogenen Fragen verlieren. -Mit der Installation im Expertenmodus hast du mehr Möglichkeiten, insbesondere was die genaue Partitionierung deiner Speichermedien betrifft. Du kannst dich auch für den klassischen Modus entscheiden und [deine Festplatten anschließend hinzufügen](/external_storage). +Mit der Installation im Expertenmodus hast du mehr Möglichkeiten, insbesondere was die genaue Partitionierung deiner Speichermedien betrifft. Du kannst dich auch für den klassischen Modus entscheiden und [deine Festplatten anschließend hinzufügen](/external_storage). + +### Zusammenfassung der Schritte im Expertenmodus -### Zusammenfassung der Schritte im Expertenmodus: 1. Wähle `Expert graphical install` aus. 2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und möglicherweise deine Zeitzone aus. 3. Partitioniere deine Festplatten. Hier kanst du ein RAID einrichten oder den Server ganz oder teilweise verschlüsseln. @@ -582,32 +584,39 @@ Wenn du über eine oder mehrere Festplatten zum Speichern von Daten verfügst, k Wenn du Flexibilität haben möchtest und die Größe von Partitionen nicht (verändern) möchtest, kannst du dich auch dafür entscheiden, auf `/mnt/hdd` zu mounten und dieser [Anleitung zum Mounten aller dieser Ordner mit `mount --bind`](/external_storage) zu folgen. ### Über Verschlüsselung + Beachte: Wenn du deine Festplatten ganz oder teilweise verschlüsselst, musst du bei jedem Neustart deines Servers die Passphrase eingeben. Das kann ein Problem darstellen, wenn du nicht vor Ort bist. Es gibt jedoch (ziemlich schwierig zu implementierende) Lösungen, die es dir ermöglichen, die Passphrase über SSH oder über eine Webseite einzugeben (suche nach "Dropbear Encrypted Disk"). ### Über RAID + Denk daran, dass: - * die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt). - * ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist. - * und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen. + +- die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt). +- ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist. +- und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen. [/ui-tab] [/ui-tabs] {% endif %} - {% if rpi012 %} + ## [fa=bug /] Mit dem Board verbinden und das Image per Hotfix reparieren + Raspberry Pi 1 und 0 werden aufgrund von [Kompilierungsproblemen für diese Architektur](https://github.com/YunoHost/issues/issues/1423) nicht vollständig unterstützt. Es ist jedoch möglich, das Image selbst zu reparieren, bevor du die Erstkonfiguration ausführst. -Um das zu erreichen, musst du dich auf deinem Raspberry Pi als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort „yunohost“ verbinden: +Um das zu erreichen, musst du dich auf deinem Raspberry Pi als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort „YunoHost“ verbinden: + ``` ssh root@yunohost.local ``` -(oder „yunohost-2.local“ usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden) + +(oder „YunoHost-2.local“ usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden) Führe dann die folgenden Befehle aus, um das Metronomproblem zu umgehen: + ``` mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronomectl{,.bkp} @@ -616,13 +625,15 @@ ln -s /usr/bin/true /usr/bin/metronomectl ``` Und diesen hier, um das UpnPC-Problem zu umgehen: + ``` sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py ``` -! Der letzte Befehl muss nach jedem Yunohost-Upgrade ausgeführt werden :/ +! Der letzte Befehl muss nach jedem YunoHost-Upgrade ausgeführt werden :/ {% elseif arm_unsup %} + ## [fa=terminal /] Verbindung zum Board Als nächstes musst du [die lokale IP-Adresse deines Servers finden](/finding_the_local_ip), um dich als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort `1234` zu verbinden. @@ -635,8 +646,8 @@ ssh root@192.168.x.xxx {% endif %} - {% if vps_debian or arm_unsup %} + ## [fa=rocket /] Das Installationsskript ausführen - Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh)) @@ -698,9 +709,9 @@ Dies ist die Domäne, über die die Benutzer deines Servers auf das **Authentifi {% if not wsl %} -* Wenn du neu im Self-Hosting bist und noch keinen Domain-Namen hast, empfehlen wir die Verwendung eines **.nohost.me** / **.noho.st** / **.ynh.fr** (z.B. `homersimpson.nohost.me`). Sofern die Domain noch nicht vergeben ist, wird sie automatisch konfiguriert und du benötigst keinen weiteren Konfigurationsschritt. Bitte beachte, dass der Nachteil darin besteht, dass du nicht die vollständige Kontrolle über die DNS-Konfiguration hast. +- Wenn du neu im Self-Hosting bist und noch keinen Domain-Namen hast, empfehlen wir die Verwendung eines **.nohost.me** / **.noho.st** / **.ynh.fr** (z.B. `homersimpson.nohost.me`). Sofern die Domain noch nicht vergeben ist, wird sie automatisch konfiguriert und du benötigst keinen weiteren Konfigurationsschritt. Bitte beachte, dass der Nachteil darin besteht, dass du nicht die vollständige Kontrolle über die DNS-Konfiguration hast. -* Wenn du bereits einen Domain-Namen besitzt, möchtest du ihn wahrscheinlich hier verwenden. Später musst du DNS-Einträge konfigurieren, so wie [hier](/dns_config) beschrieben. +- Wenn du bereits einen Domain-Namen besitzt, möchtest du ihn wahrscheinlich hier verwenden. Später musst du DNS-Einträge konfigurieren, so wie [hier](/dns_config) beschrieben. !!! Ja, du *musst* eine Domain-Namen konfigurieren. Wenn du keinen Domain-Namen hast und auch keine **.nohost.me** / **.noho.st** / **.ynh.fr** möchtest, kannst du eine Dummy-Domain einrichten wie `yolo.test` und passt deine **lokale** `/etc/hosts` Datei so an, dass diese Dummy-Domain [auf die entsprechende IP verweist, wie hier erklärt](/dns_local_network). @@ -729,7 +740,6 @@ Wenn du Subdomains erstellen möchtest, denk daran, diese auch in der Datei `hos Dieser Benutzer ersetzt den alten `admin` Benutzer, auf den sich einige alte Dokumentationsseiten möglicherweise noch beziehen. In diesem Fall: Ersetzen Sie einfach `admin` durch Ihren Benutzernamen. - ## [fa=stethoscope /] Die Erstdiagnose durchführen Sobald die Post-Installation abgeschlossen ist, solltest du dich tatsächlich mit den Credentials des ersten Benutzers, den du gerade erstellt hast, bei der Webadministrationsoberfläche anmelden können. @@ -747,7 +757,6 @@ Das Diagnosesystem soll eine einfache Möglichkeit bieten, zu überprüfen, ob a !!! Ist eine Warnung für dich nicht relevant (z.B. weil du nicht vor hast, eine bestimmte Funktion zu verwenden), ist es völlig in Ordnung, das Problem als 'ignoriert' zu markieren, indem du im Webadmin > Diagnose auf den "Ignorieren" Button (für diese bestimmte Funktion) klickst. - [ui-tabs position="top-left" active="0" theme="lite"] [ui-tab title="(Empfohlen) Über die Weboberfläche"] Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". Klicke auf "Erstdiagnose ausführen". Du solltest nun einen Bildschirm wie diesen erhalten: @@ -758,10 +767,12 @@ Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". K [/ui-tab] [ui-tab title="In der Kommandozeile"] + ``` yunohost diagnosis run yunohost diagnosis show --issues --human-readable ``` + [/ui-tab] [/ui-tabs] @@ -782,9 +793,11 @@ Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat [/ui-tab] [ui-tab title="In der Kommandozeile"] + ```bash yunohost domain cert install ``` + [/ui-tab] [/ui-tabs] diff --git a/pages/02.administer/10.install/install.fr.md b/pages/02.administer/10.install/install.fr.md index f5221d8a..84758b3f 100644 --- a/pages/02.administer/10.install/install.fr.md +++ b/pages/02.administer/10.install/install.fr.md @@ -126,56 +126,53 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost : [/div] - {% if hardware != '' %} ## [fa=list-alt /] Pré-requis {% if regular %} -* Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur avec 512Mo de RAM et 16Go de capacité de stockage (au moins) ; +- Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur avec 512Mo de RAM et 16Go de capacité de stockage (au moins) ; {% elseif rpi34 %} -* Un Raspberry Pi 3 ou 4 ; +- Un Raspberry Pi 3 ou 4 ; {% elseif rpi012 %} -* Un Raspberry Pi 0, 1 ou 2 avec au moins 512Mo de RAM ; +- Un Raspberry Pi 0, 1 ou 2 avec au moins 512Mo de RAM ; {% elseif internetcube %} -* Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ; -* Un VPN avec une IP publique dédiée et un fichier `.cube` ; +- Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ; +- Un VPN avec une IP publique dédiée et un fichier `.cube` ; {% elseif arm_sup %} -* Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ; +- Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ; {% elseif arm_unsup %} -* Une carte ARM avec au moins 512Mo de RAM ; +- Une carte ARM avec au moins 512Mo de RAM ; {% elseif vps_debian %} -* Un serveur dédié ou virtuel avec Debian 11 (Bullseye) pré-installé (avec un **kernel >= 3.12**), avec au moins 512Mo de RAM et 16Go de capacité de stockage ; +- Un serveur dédié ou virtuel avec Debian 11 (Bullseye) pré-installé (avec un **kernel >= 3.12**), avec au moins 512Mo de RAM et 16Go de capacité de stockage ; {% elseif vps_ynh %} -* Un serveur dédié ou virtuel avec YunoHost pré-installé, avec au moins 512Mo de RAM et 16Go de capacité de stockage ; +- Un serveur dédié ou virtuel avec YunoHost pré-installé, avec au moins 512Mo de RAM et 16Go de capacité de stockage ; {% elseif virtualbox %} -* Un ordinateur x86 avec [VirtualBox installé](https://www.virtualbox.org/wiki/Downloads) et assez de RAM disponible pour lancer une petite machine virtuelle avec au moins 1024Mo de RAM et 8Go de capacité de stockage ; +- Un ordinateur x86 avec [VirtualBox installé](https://www.virtualbox.org/wiki/Downloads) et assez de RAM disponible pour lancer une petite machine virtuelle avec au moins 1024Mo de RAM et 8Go de capacité de stockage ; {% endif %} {% if arm %} -* Une alimentation électrique (soit un adaptateur, soit un câble microUSB) pour alimenter la carte ; -* Une carte microSD : au moins 16Go de capacité, [classe « A1 »](https://fr.wikipedia.org/wiki/Carte_SD#Vitesse) hautement recommandée (comme par exemple [cette carte SanDisk A1](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)) ; +- Une alimentation électrique (soit un adaptateur, soit un câble microUSB) pour alimenter la carte ; +- Une carte microSD : au moins 16Go de capacité, [classe « A1 »](https://fr.wikipedia.org/wiki/Carte_SD#Vitesse) hautement recommandée (comme par exemple [cette carte SanDisk A1](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)) ; {% endif %} {% if regular %} -* Une clé USB avec au moins 1Go de capacité OU un CD vierge standard ; +- Une clé USB avec au moins 1Go de capacité OU un CD vierge standard ; {% endif %} {% if at_home %} -* Un [fournisseur d'accès à Internet correct](/isp), de préférence avec une bonne vitesse d’upload ; +- Un [fournisseur d'accès à Internet correct](/isp), de préférence avec une bonne vitesse d’upload ; {% if not virtualbox %} -* Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet {% if rpi012 %} (Ou pour Rasperry Pi Zero : Un câble OTG ou un adaptateur Wifi USB) {% endif %} ; +- Un câble ethernet/RJ-45 pour brancher la carte à votre routeur/box internet {% if rpi012 %} (Ou pour Rasperry Pi Zero : Un câble OTG ou un adaptateur Wifi USB) {% endif %} ; {% endif %} -* Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur. +- Un ordinateur pour lire ce guide, flasher l'image et accéder à votre serveur. {% else %} -* Un ordinateur ou un smartphone pour lire ce guide et accéder à votre serveur. +- Un ordinateur ou un smartphone pour lire ce guide et accéder à votre serveur. {% endif %} {% if virtualbox %} ! N.B. : Installer YunoHost dans une VirtualBox est généralement destiné à tester la distribution ou pour développer. VirtualBox n'est pas pratique pour faire tourner un 'vrai' serveur sur le long terme car la machine surlaquelle il est installé ne sera sans doute pas allumé 24h/24, et parce que Virtualbox rajoute une couche de complexité supplémentaire pour ce qui est d'exposer la machine sur Internet. {% endif %} - - - {% if vps_ynh %} + ## Fournisseurs de VPS YunoHost Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost : @@ -194,8 +191,8 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost : [/div] {% endif %} - {% if at_home %} + ## [fa=download /] Télécharger l'image {{image_type}} {% if rpi012 %} @@ -261,7 +258,7 @@ $(document).ready(function () { .replace('%7Bimage%7D', infos.image) .replace('{image}', infos.image) .replace('{version}', infos.version); - + if (!infos.file.startsWith("http")) infos.file="https://build.yunohost.org/"+infos.file; html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); @@ -278,17 +275,16 @@ $(document).ready(function () { }); - - - - - {% if not virtualbox %} {% if arm %} + ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flasher l'image {{image_type}} + {% else %} + ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flasher l'image YunoHost + {% endif %} Maintenant que vous avez téléchargé l’image de {{image_type}}, vous devez la mettre sur {% if arm %}une carte microSD{% else %}une clé USB ou un CD/DVD.{% endif %} @@ -328,23 +324,24 @@ dd if=/path/to/yunohost.img of=/dev/mmcblk0 [ui-tab title="Copier un CD/DVD"] Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logiciel à utiliser est différent suivant votre système d’exploitation. -* Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque +- Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque -* Sur macOS, utilisez [Disk Utility](http://support.apple.com/kb/ph7025) +- Sur macOS, utilisez [Disk Utility](http://support.apple.com/kb/ph7025) -* Sur GNU/Linux, vous avez plusieurs choix, tels que [Brasero](https://wiki.gnome.org/Apps/Brasero) ou [K3b](http://www.k3b.org/) +- Sur GNU/Linux, vous avez plusieurs choix, tels que [Brasero](https://wiki.gnome.org/Apps/Brasero) ou [K3b](http://www.k3b.org/) [/ui-tab] [ui-tab title="Utiliser Ventoy"] -Ventoy sera utile si vous n'arrivez pas à démarrer l'image de Yunohost en utilisant les autres méthodes +Ventoy sera utile si vous n'arrivez pas à démarrer l'image de YunoHost en utilisant les autres méthodes [Ventoy](https://www.ventoy.net/) est un outil pratique qui permet de mettre plusieurs images Linux sur une même clé USB et démarrer ces images sans devoir re-flasher la clé USB à chaque fois. C'est aussi pratique pour démarer une image qui refuse de démarrer: Ventoy réussi habituellement à tout démarrer! + 1. Installer [Ventoy](https://www.ventoy.net/) sur la clé USB. Référez-vous aux [instructions d'installation](https://www.ventoy.net/en/doc_start.html). - Cela va créer 2 partition sur la clé USB. -3. En utilisant votre application de fichiers préférée, copiez l'image Yunohost sur la grande partition "Ventoy (pas celle "VTOYEFI") +3. En utilisant votre application de fichiers préférée, copiez l'image YunoHost sur la grande partition "Ventoy (pas celle "VTOYEFI") - N'utilisez pas *Balena Etcher*, USBImager ou `dd` pour faire ça! -Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Ventoy va apparaitre et lister toutes les images qui sont sur la clé USB. Sélectionnez l'image de Yunohost. Sélectionnez ensuite "GRUB2" comme option de démarrage (ou utilisez n'importe laquelle qui fonctionnera sur votre ordinateur 😉) +Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Ventoy va apparaitre et lister toutes les images qui sont sur la clé USB. Sélectionnez l'image de YunoHost. Sélectionnez ensuite "GRUB2" comme option de démarrage (ou utilisez n'importe laquelle qui fonctionnera sur votre ordinateur 😉) [/ui-tab] {% endif %} [/ui-tabs] @@ -363,34 +360,28 @@ Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Vent Allez dans **Réglages** > **Réseau** : -* Sélectionnez `Accès par pont` -* Choisissez votre interface selon son nom : +- Sélectionnez `Accès par pont` +- Choisissez votre interface selon son nom : **wlan0** si vous êtes connecté sans-fil, **eth0** ou **eno1** sinon. ![](image://virtualbox_2.png?class=inline) {% endif %} - - - - - - - - {% if arm %} + ## [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.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. -* Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage. -* Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur. +- 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.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. +- Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage. +- Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur. {% elseif virtualbox %} + ## [fa=plug /] Lancer la machine virtuelle Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost. @@ -400,19 +391,20 @@ Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost. ! Si vous rencontrez l'erreur "VT-x is not available", il vous faut probablement activer (enable) la virtualisation dans les options du BIOS de votre ordinateur. {% else %} + ## [fa=plug /] Démarrer la machine sur la clé USB -* Branchez le câble Ethernet (un côté à votre box, de l'autre côté à votre carte). -* Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant l’une des touches suivantes (dépendant de votre ordinateur) : +- Branchez le câble Ethernet (un côté à votre box, de l'autre côté à votre carte). +- Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant l’une des touches suivantes (dépendant de votre ordinateur) : ``, ``, ``, ``, ``, `` ou . - * N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une option du menu « Options de démarrage avancées ». - -!!! Si vous n'arrivez pas à démarrer l'image Yunohost, essayez d'utiliser Ventoy (sélectionnez "Ventoy" dans la section "Flasher l'image YunoHost" ci-dessus). + - N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une option du menu « Options de démarrage avancées ». + +!!! Si vous n'arrivez pas à démarrer l'image YunoHost, essayez d'utiliser Ventoy (sélectionnez "Ventoy" dans la section "Flasher l'image YunoHost" ci-dessus). {% endif %} {% if regular or virtualbox %} -## [fa=rocket /] Lancer l’installation graphique +## [fa=rocket /] Lancer l’installation graphique Votre écran devrait ressembler à la capture ci-dessous : @@ -432,9 +424,10 @@ Votre écran devrait ressembler à la capture ci-dessous : Le projet YunoHost a simplifié au maximum l'installation classique afin d'éviter au plus grand nombre d'être perdu avec des questions trop techniques ou liées à des cas particuliers. -Avec l'installation en mode expert, vous avez plus de possibilités notamment concernant le partitionnement exact de vos supports de stockages. Vous pouvez aussi décider d'utiliser le mode classique et [ajouter vos disques après coup](/external_storage). +Avec l'installation en mode expert, vous avez plus de possibilités notamment concernant le partitionnement exact de vos supports de stockages. Vous pouvez aussi décider d'utiliser le mode classique et [ajouter vos disques après coup](/external_storage). + +### Résumé des étapes en mode expert -### Résumé des étapes en mode expert: 1. Sélectionnez `Expert graphical install` 2. Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone. 3. Partitionner vos disques. C'est à cette étape que vous pouvez configurer un RAID ou chiffrer tout ou partie du serveur. @@ -460,34 +453,41 @@ Si vous avez un ou des disques durs pour stocker les données, vous pouvez chois Si vous souhaitez de la souplesse et ne pas avoir à (re-)dimensionner des partitions, vous pouvez aussi choisir de monter sur `/mnt/hdd` et de suivre ce [tutoriel pour monter l'ensemble de ces dossiers avec `mount --bind`](/external_storage). ### A propos du chiffrement + Prenez bien en compte que si vous chiffrez tout ou partie de vos disques, vous aurez à taper la phrase de passe à chaque redémarrage de votre serveur, ce qui peut poser problème si vous n'êtes pas sur place. Il existe toutefois des solutions (assez difficiles à mettre en oeuvre) qui permettent de tapper la phrase via SSH ou via une page web (cherchez "dropbear encrypted disk"). ### A propos du RAID + Ne perdez pas de vue que: - * les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD) - * un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité - * les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe + +- les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD) +- un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité +- les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe [/ui-tab] [/ui-tabs] -!!! Si l'installation de Yunohost échoue sur votre machine et que vous n'arrivez pas à résoudre le problème, sachez qu'il est aussi possible d'installer Debian et ensuite d'installer Yunohost dessus. Pour les instructions, au sommet de cette page, sélectionnez "Serveur distant" puis "VPS ou serveur dédié avec Debian". +!!! Si l'installation de YunoHost échoue sur votre machine et que vous n'arrivez pas à résoudre le problème, sachez qu'il est aussi possible d'installer Debian et ensuite d'installer YunoHost dessus. Pour les instructions, au sommet de cette page, sélectionnez "Serveur distant" puis "VPS ou serveur dédié avec Debian". {% endif %} - {% if rpi012 %} + ## [fa=bug /] Se connecter à la carte et corriger l'image + Les Raspberry Pi 1 et Zero ne sont pas totalement supportés à cause de [problèmes de compilation pour cette architecture](https://github.com/YunoHost/issues/issues/1423). Cependant, il est possible de corriger l'image par vous-même avant de lancer la configuration initiale. Pour y parvenir, vous devez vous connecter à votre Raspberry Pi en tant que root [via SSH](/ssh) avec le mot de passe temporaire `yunohost`: + ``` ssh root@yunohost.local ``` + (utilisez `yunohost-2.local`, etc. s'il y a plusieurs serveurs YunoHost sur le réseau) Ensuite, lancez les commandes suivantes pour contourner le dysfonctionnement de Metronome : + ``` mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronomectl{,.bkp} @@ -496,6 +496,7 @@ ln -s /usr/bin/true /usr/bin/metronomectl ``` Et celle-ci pour contourner celui de upnpc : + ``` sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py ``` @@ -503,6 +504,7 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir ! Cette dernière commande nécessite d'être lancée après chaque mise à jour de YunoHost :/ {% elseif arm_unsup %} + ## [fa=terminal /] Se connecter à la carte Ensuite, il vous faut [trouver l'adresse IP locale de votre serveur](/finding_the_local_ip) pour vous connecter en tant que root [via SSH](/ssh) avec le mot de passe temporaire `1234`. @@ -515,8 +517,8 @@ ssh root@192.168.x.xxx {% endif %} - {% if vps_debian or arm_unsup %} + ## [fa=rocket /] Lancer le script d'installation - Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh)) @@ -526,6 +528,7 @@ ssh root@192.168.x.xxx ```bash curl https://install.yunohost.org | bash ``` + !!! Si `curl` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install curl`. !!! Autrement, si la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates` @@ -533,7 +536,6 @@ curl https://install.yunohost.org | bash {% endif %} - ## [fa=cog /] Lancer la configuration initiale !!! Si vous êtes en train de restaurer une sauvegarde YunoHost, vous devez sauter cette étape et vous référer à la section [Restaurer durant la post-installation à la place de cette étape de configuration initiale](/backup#restoring-during-the-postinstall). @@ -576,16 +578,16 @@ Vous pouvez aussi lancer la post-installation avec la commande `yunohost tools p C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’au **portail d’authentification** des utilisateurs. Vous pourrez ensuite ajouter d'autres domaines, et changer celui qui sera le domaine principal si besoin. -* Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en **.nohost.me** / **.noho.st** / **.ynh.fr** (exemple : `homersimpson.nohost.me`). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS. +- Si l'auto-hébergement est tout neuf pour vous et que vous n'avez pas encore de nom de domaine, nous recommandons d'utiliser un domaine en **.nohost.me** / **.noho.st** / **.ynh.fr** (exemple : `homersimpson.nohost.me`). S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. Toutefois, notez que l'utilisation d'un de ces noms de domaines implique que vous n'aurez pas le contrôle complet sur votre configuration DNS. -* Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué [ici](/dns_config). +- Si en revanche vous avez déjà votre propre nom de domaine, vous souhaitez probablement l'utiliser. Vous aurez donc besoin ensuite de configurer les enregistrements DNS comme expliqué [ici](/dns_config). !!! Oui, vous *devez* configurer un nom de domaine. Si vous n'avez pas de nom de domaine et que vous n'en voulez pas en **.nohost.me**, **.noho.st** ou **.ynh.fr**, vous pouvez utilisez un « faux » domaine comme par exemple `yolo.test` et [modifier votre fichier `/etc/hosts` **sur votre ordinateur local** pour que ce domaine pointe vers l'IP de votre serveur, comme expliqué ici](/dns_local_network). ##### [fa=key /] Premier compte utilisateur [Depuis YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378), le premier compte utilisateur est créé à cette étape. Il vous faudra choisir un nom d'utilisateur et un mot de passe raisonablement complexe. (Nous ne pouvons que souligner l'importance du choix d'un mot de passe **robuste** !) Ce compte utilisateur sera ajouté au groupe Admins, et pourra se connecter au portail utilisateur, à la webadmin, et se connecter [via **SSH**](/ssh) ou [**SFTP**](/filezilla). Les admins recevront aussi les mails envoyés à `root@votredomaine.tld` et `admin@votredomaine.tld` : ces emails peuvent être utilisés pour envoyer des informations ou des alertes techniques. Vous pourrez plus tard ajouter d'autres comptes utilisateur supplémentaire, qu'il est aussi possible d'ajouter au groupe Admins. - + Ce compte remplace l'ancien compte `admin`, qui est peut être toujours mentionné dans certaines pages de documentation. Dans ce cas, remplacez simplement `admin` par votre identifiant. ## [fa=stethoscope /] Lancer le diagnostic @@ -612,10 +614,12 @@ Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagno [/ui-tab] [ui-tab title="À partir de la ligne de commande"] + ``` yunohost diagnosis run yunohost diagnosis show --issues --human-readable ``` + [/ui-tab] [/ui-tabs] @@ -634,9 +638,11 @@ Pour plus d'instructions détaillées, ou pour en savoir plus à propos des cert [/ui-tab] [ui-tab title="À partir de la ligne de commande"] + ``` yunohost domain cert install ``` + [/ui-tab] [/ui-tabs] diff --git a/pages/02.administer/10.install/install.md b/pages/02.administer/10.install/install.md index d9890a3a..94d2635d 100644 --- a/pages/02.administer/10.install/install.md +++ b/pages/02.administer/10.install/install.md @@ -132,57 +132,55 @@ Select the hardware on which you want install YunoHost : [/div] - {% if hardware != '' %} {% if wsl %} !! This setup is mainly meant for local testing by advanced users. Due to limitations on WSL's side (changing IP address, notably), selfhosting from it can be tricky and will not be described here. {% endif %} - ## [fa=list-alt /] Pre-requisites {% if regular %} -* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least) +- A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least) {% elseif rpi34 %} -* A Raspberry Pi 3 or 4 +- A Raspberry Pi 3 or 4 {% elseif rpi012 %} -* A Raspberry Pi 0, 1 or 2 with at least 512MB RAM +- A Raspberry Pi 0, 1 or 2 with at least 512MB RAM {% elseif internetcube %} -* An Orange Pi PC+ or an Olinuxino Lime 1 or 2 -* A VPN with a dedicated public IP and a `.cube` file +- An Orange Pi PC+ or an Olinuxino Lime 1 or 2 +- A VPN with a dedicated public IP and a `.cube` file {% elseif arm_sup %} -* An Orange Pi PC+ or an Olinuxino Lime 1 or 2 +- An Orange Pi PC+ or an Olinuxino Lime 1 or 2 {% elseif arm_unsup %} -* An ARM board with at least 512MB RAM +- An ARM board with at least 512MB RAM {% elseif vps_debian %} -* A dedicated or virtual private server with Debian 11 (Bullseye) (with **kernel >= 3.12**) preinstalled, 512MB RAM and 16GB capacity (at least) +- A dedicated or virtual private server with Debian 11 (Bullseye) (with **kernel >= 3.12**) preinstalled, 512MB RAM and 16GB capacity (at least) {% elseif vps_ynh %} -* A dedicated or virtual private server with yunohost preinstalled, 512MB RAM and 16GB capacity (at least) +- A dedicated or virtual private server with YunoHost preinstalled, 512MB RAM and 16GB capacity (at least) {% elseif virtualbox %} -* An x86 computer with [VirtualBox installed](https://www.virtualbox.org/wiki/Downloads) and enough RAM capacity to be able to run a small virtual machine with 1024MB RAM and 8GB capacity (at least) +- An x86 computer with [VirtualBox installed](https://www.virtualbox.org/wiki/Downloads) and enough RAM capacity to be able to run a small virtual machine with 1024MB RAM and 8GB capacity (at least) {% endif %} {% if arm %} -* A power supply (either an adapter or a MicroUSB cable) for your board; -* A microSD card: 16GB capacity (at least), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) highly recommended (such as [this SanDisk A1 card](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)); +- A power supply (either an adapter or a MicroUSB cable) for your board; +- A microSD card: 16GB capacity (at least), [class "A1"](https://en.wikipedia.org/wiki/SD_card#Class) highly recommended (such as [this SanDisk A1 card](https://www.amazon.fr/SanDisk-microSDHC-Adaptateur-homologu%C3%A9e-Nouvelle/dp/B073JWXGNT/)); {% endif %} {% if regular %} -* A USB stick with at least 1GB capacity OR a standard blank CD +- A USB stick with at least 1GB capacity OR a standard blank CD {% endif %} {% if wsl %} -* Windows 10 and above -* Administration rights -* Windows Subsystem for Linux, installed from the Optional Features menu of Windows -* *Recommended:* Windows Terminal (Preview) app, installed from the Microsoft Store. Much better than the standard Terminal, as it offers shortcuts to the WSL distros. +- Windows 10 and above +- Administration rights +- Windows Subsystem for Linux, installed from the Optional Features menu of Windows +- *Recommended:* Windows Terminal (Preview) app, installed from the Microsoft Store. Much better than the standard Terminal, as it offers shortcuts to the WSL distros. {% endif %} {% if at_home %} -* A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth +- A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth {% if not virtualbox %} -* An ethernet cable (RJ-45) to connect your server to your router. {% if rpi012 %} (Or, for Rasperry Pi Zero : and USB OTG or a wifi Dongle) {% endif %} +- An ethernet cable (RJ-45) to connect your server to your router. {% if rpi012 %} (Or, for Rasperry Pi Zero : and USB OTG or a wifi Dongle) {% endif %} {% endif %} -* A computer to read this guide, flash the image and access your server. +- A computer to read this guide, flash the image and access your server. {% else %} -* A computer or a smartphone to read this guide and access your server. +- A computer or a smartphone to read this guide and access your server. {% endif %} {% if virtualbox %} @@ -190,7 +188,9 @@ Select the hardware on which you want install YunoHost : {% endif %} {% if wsl %} + ## Introduction + WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless. Docker for Windows can now rely on WSL instead of Hyper-V, for example. @@ -216,7 +216,7 @@ rmdir .\debian -R You can now access it: run `wsl.exe -d YunoHost` -It is under Debian 9 Stretch, so let's upgrade it: +It is under Debian 9 Stretch, so let's upgrade it: ```bash # In WSL @@ -225,6 +225,7 @@ sudo apt update sudo apt upgrade sudo apt dist-upgrade ``` + ## Prevent WSL from tweaking configuration files Edit `/etc/wsl.conf` and put the following code in it: @@ -252,6 +253,7 @@ Debian on WSL does not have `systemd`, a service configuration software. This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it: 1. Install dotNET runtime: + ```bash # In WSL wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb @@ -263,6 +265,7 @@ sudo apt install -y dotnet-sdk-3.1 ``` 2. Install [Genie](https://github.com/arkane-systems/genie): + ```bash # In WSL # Add their repository @@ -291,8 +294,10 @@ Always call `genie -s` while starting your distro. `wsl -d YunoHost -e genie -s` -## Backup and restore the distro +## Backup and restore the distro + ### Make your first distro backup + As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell: ``` @@ -307,10 +312,11 @@ cd ~ wsl --unregister YunoHost wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 ``` + {% endif %} - {% if vps_ynh %} + ## YunoHost VPS providers Here are some VPS providers supporting YunoHost natively : @@ -329,8 +335,8 @@ Here are some VPS providers supporting YunoHost natively : [/div] {% endif %} - {% if at_home %} + ## [fa=download /] Download the {{image_type}} image {% if rpi012 %} @@ -396,7 +402,7 @@ $(document).ready(function () { .replace('%7Bimage%7D', infos.image) .replace('{image}', infos.image) .replace('{version}', infos.version); - + if (!infos.file.startsWith("http")) infos.file="https://build.yunohost.org/"+infos.file; html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); @@ -413,17 +419,16 @@ $(document).ready(function () { }); - - - - - {% if not virtualbox %} {% if arm %} + ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image + {% else %} + ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image + {% endif %} Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %} @@ -457,27 +462,29 @@ Then run : # Replace /dev/mmcblk0 if the name of your device is different... dd if=/path/to/yunohost.img of=/dev/mmcblk0 ``` + [/ui-tab] {% if regular %} [ui-tab title="Burning a CD/DVD"] For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system. -* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc +- On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc -* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025) +- On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025) -* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/) +- On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/) [/ui-tab] [ui-tab title="Using Ventoy"] -Ventoy will be useful if you can't sucessfully boot the Yunohost image using the other methods. +Ventoy will be useful if you can't sucessfully boot the YunoHost image using the other methods. [Ventoy](https://www.ventoy.net/) is a nice tool that makes it really easy to put multiple linux images on a USB stick. When the computer refuses to boot from an image on a usb stick, Ventoy will usually be able to boot it anyway! + 1. Install [Ventoy](https://www.ventoy.net/) on the USB stick. Refer to the [install instructions](https://www.ventoy.net/en/doc_start.html). - This will create 2 partitions on the stick. -3. Using your favorite file explorer app, copy the Yunohost image file on the big `Ventoy` partition (not "VTOYEFI") +3. Using your favorite file explorer app, copy the YunoHost image file on the big `Ventoy` partition (not "VTOYEFI") - Don't use *Balena Etcher*, USBImager or `dd` for this! -Later, when you'll boot the computer using this usb stick, Ventoy will appear and will list the images on the USB stick. Select the Yunohost image, then select GRUB2 launch option (or use whichever works for your computer 😉) +Later, when you'll boot the computer using this usb stick, Ventoy will appear and will list the images on the USB stick. Select the YunoHost image, then select GRUB2 launch option (or use whichever works for your computer 😉) [/ui-tab] {% endif %} [/ui-tabs] @@ -496,34 +503,28 @@ Later, when you'll boot the computer using this usb stick, Ventoy will appear an Go to **Settings** > **Network**: -* Select `Bridged adapter` -* Select your interface's name: +- Select `Bridged adapter` +- Select your interface's name: **wlan0** if you are connected wirelessly, or **eth0** otherwise. ![](image://virtualbox_2.png?class=inline) {% endif %} - - - - - - - - {% if arm %} + ## [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.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 -* Wait a couple minutes while the board autoconfigure itself during the first boot -* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server. +- 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.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 +- Wait a couple minutes while the board autoconfigure itself during the first boot +- Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server. {% elseif virtualbox %} + ## [fa=plug /] Boot up the virtual machine Start the virtual machine after selecting the YunoHost image. @@ -532,19 +533,20 @@ Start the virtual machine after selecting the YunoHost image. ! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer. - {% else %} + ## [fa=plug /] Boot the machine on your USB stick -* Plug the ethernet cable (one side on your main router, the other on your server). -* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device**. Depending on your hardware, you will need to press one of the following keys: +- Plug the ethernet cable (one side on your main router, the other on your server). +- Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device**. Depending on your hardware, you will need to press one of the following keys: ``, ``, ``, ``, ``, `` or ``. - * N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options". + - N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options". -!!! If you can't boot the Yunohost image, try using Ventoy (select "Ventoy" in the section "Flash the YunoHost image" above). +!!! If you can't boot the YunoHost image, try using Ventoy (select "Ventoy" in the section "Flash the YunoHost image" above). {% endif %} {% if regular or virtualbox %} + ## [fa=rocket /] Launch the graphical install You should see a screen like this: @@ -567,9 +569,10 @@ You should see a screen like this: The YunoHost project simplified the classic installation as much as possible in order to avoid as many people as possible being lost with questions that are too technical or related to specific cases. -With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage). +With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage). + +### Summary of the steps in expert mode -### Summary of the steps in expert mode: 1. Select `Expert graphical install`. 2. Select your language, location, keyboard layout and possibly your timezone. 3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server. @@ -595,34 +598,41 @@ If you have one or more hard drives to store data, you can choose to mount it on If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage). ### About encryption + Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk"). ### About RAID + Keep in mind that: - * the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs) - * a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view - * hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array + +- the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs) +- a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view +- hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array [/ui-tab] [/ui-tabs] -!!! If the Yunohost installer fails and you can't solve the issue, know that it's also possible to install Debian and then install Yunohost on top. For instructions, at the top of this page, select "Remote server", then "VPS or dedicated server with Debian". +!!! If the YunoHost installer fails and you can't solve the issue, know that it's also possible to install Debian and then install YunoHost on top. For instructions, at the top of this page, select "Remote server", then "VPS or dedicated server with Debian". {% endif %} - {% if rpi012 %} + ## [fa=bug /] Connect to the board and hotfix the image + Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423). However, it is possible to fix by yourself the image before to run the initial configuration. To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`: + ``` ssh root@yunohost.local ``` + (or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network) Then run the following commands to work around the metronome issue: + ``` mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronomectl{,.bkp} @@ -631,13 +641,15 @@ ln -s /usr/bin/true /usr/bin/metronomectl ``` And this one to work around the upnpc issue: + ``` sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py ``` -! This last command need to be run after each yunohost upgrade :/ +! This last command need to be run after each YunoHost upgrade :/ {% elseif arm_unsup %} + ## [fa=terminal /] Connect to the board Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`. @@ -650,8 +662,8 @@ ssh root@192.168.x.xxx {% endif %} - {% if vps_debian or arm_unsup %} + ## [fa=rocket /] Run the install script - Open a command line prompt on your server (either directly or [through SSH](/ssh)) @@ -713,9 +725,9 @@ This will be the domain used by your server's users to access the **authenticati {% if not wsl %} -* If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration. +- If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration. -* If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config). +- If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config). !!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your **local** `/etc/hosts` file such that this dummy domain [points to the appropriate IP, as explained here](/dns_local_network). @@ -744,7 +756,6 @@ If you want to create subdomains, do not forget to add them in the `hosts` file This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username. - ## [fa=stethoscope /] Run the initial diagnosis Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created. @@ -772,10 +783,12 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial [/ui-tab] [ui-tab title="From the command line"] + ``` yunohost diagnosis run yunohost diagnosis show --issues --human-readable ``` + [/ui-tab] [/ui-tabs] @@ -796,9 +809,11 @@ Go in Domains > Click on your domain > SSL Certificate [/ui-tab] [ui-tab title="From the command line"] + ``` yunohost domain cert install ``` + [/ui-tab] [/ui-tabs] diff --git a/pages/02.administer/10.install/install.ru.md b/pages/02.administer/10.install/install.ru.md index 060545f1..64c2e0a3 100644 --- a/pages/02.administer/10.install/install.ru.md +++ b/pages/02.administer/10.install/install.ru.md @@ -132,57 +132,56 @@ routes: [/div] - {% if hardware != '' %} {% if wsl %} !! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет. {% endif %} - ## [fa=list-alt /] Предварительные условия {% if regular %} -* x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее) + +- x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее) {% elseif rpi34 %} -* Raspberry Pi 3 or 4 +- Raspberry Pi 3 or 4 {% elseif rpi012 %} -* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ +- Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ {% elseif internetcube %} -* Orange Pi PC+ или Olinuxino Lime 1 или 2 -* VPN с выделенным общедоступным IP-адресом и файлом `.cube` +- Orange Pi PC+ или Olinuxino Lime 1 или 2 +- VPN с выделенным общедоступным IP-адресом и файлом `.cube` {% elseif arm_sup %} -* Orange Pi PC+ или Olinuxino Lime 1 или 2 +- Orange Pi PC+ или Olinuxino Lime 1 или 2 {% elseif arm_unsup %} -* Плата ARM с объемом оперативной памяти не менее 512 МБ +- Плата ARM с объемом оперативной памяти не менее 512 МБ {% elseif vps_debian %} -* Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) (с **kernel >= 3.12**) предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее) +- Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) (с **kernel >= 3.12**) предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее) {% elseif vps_ynh %} -* Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ +- Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ {% elseif virtualbox %} -* Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум). +- Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум). {% endif %} {% if arm %} *Источник питания (либо адаптер, либо кабель microUSB) для вашей платы; -* Карта microSD: емкость 16 ГБ (не менее), [класса "A1"](https://club.dns-shop.ru/blog/t-127-kartyi-pamyati/59683-klassyi-skorosti-kart-pamyati-kak-razobratsya-i-chto-brat/#sub_Klass__skorosti__dlya__rabotyi__s__prilojeniyami) настоятельно рекомендуется (например, [эта SanDisk A1 карта](https://www.dns-shop.ru/product/dd976fc32e66ed20/karta-pamati-sandisk-ultra-microsdxc-64-gb-sdsqua4-064g-gn6mn/)); +- Карта microSD: емкость 16 ГБ (не менее), [класса "A1"](https://club.dns-shop.ru/blog/t-127-kartyi-pamyati/59683-klassyi-skorosti-kart-pamyati-kak-razobratsya-i-chto-brat/#sub_Klass__skorosti__dlya__rabotyi__s__prilojeniyami) настоятельно рекомендуется (например, [эта SanDisk A1 карта](https://www.dns-shop.ru/product/dd976fc32e66ed20/karta-pamati-sandisk-ultra-microsdxc-64-gb-sdsqua4-064g-gn6mn/)); {% endif %} {% if regular %} -* USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск +- USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск {% endif %} {% if wsl %} -* Windows 10 и выше -* Права администратора -* Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows* -* *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL. +- Windows 10 и выше +- Права администратора +- Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows* +- *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL. {% endif %} {% if at_home %} -* [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания +- [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания {% if not virtualbox %} -* Кабель Ethernet (RJ-45) для подключения вашего сервера к маршрутизатору. {% if rpi012 %} (Или, для Rasperry Pi Zero: и USB OTG или wifi-адаптер) {% endif %} +- Кабель Ethernet (RJ-45) для подключения вашего сервера к маршрутизатору. {% if rpi012 %} (Или, для Rasperry Pi Zero: и USB OTG или wifi-адаптер) {% endif %} {% endif %} -* Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу. +- Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу. {% else %} -* Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу. +- Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу. {% endif %} {% if virtualbox %} @@ -190,7 +189,9 @@ routes: {% endif %} {% if wsl %} + ## Вступление + WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless. Docker for Windows can now rely on WSL instead of Hyper-V, for example. @@ -216,7 +217,7 @@ rmdir .\debian -R You can now access it: run `wsl.exe -d YunoHost` -It is under Debian 9 Stretch, so let's upgrade it: +It is under Debian 9 Stretch, so let's upgrade it: ```bash # In WSL @@ -225,6 +226,7 @@ sudo apt update sudo apt upgrade sudo apt dist-upgrade ``` + ## Prevent WSL from tweaking configuration files Edit `/etc/wsl.conf` and put the following code in it: @@ -252,6 +254,7 @@ Debian on WSL does not have `systemd`, a service configuration software. This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it: 1. Install dotNET runtime: + ```bash # In WSL wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb @@ -263,6 +266,7 @@ sudo apt install -y dotnet-sdk-3.1 ``` 2. Install [Genie](https://github.com/arkane-systems/genie): + ```bash # In WSL # Add their repository @@ -291,8 +295,10 @@ Always call `genie -s` while starting your distro. `wsl -d YunoHost -e genie -s` -## Backup and restore the distro +## Backup and restore the distro + ### Make your first distro backup + As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell: ``` @@ -307,10 +313,11 @@ cd ~ wsl --unregister YunoHost wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 ``` + {% endif %} - {% if vps_ynh %} + ## YunoHost VPS providers Here are some VPS providers supporting YunoHost natively : @@ -329,8 +336,8 @@ Here are some VPS providers supporting YunoHost natively : [/div] {% endif %} - {% if at_home %} + ## [fa=download /] Download the {{image_type}} image {% if rpi012 %} @@ -396,7 +403,7 @@ $(document).ready(function () { .replace('%7Bimage%7D', infos.image) .replace('{image}', infos.image) .replace('{version}', infos.version); - + if (!infos.file.startsWith("http")) infos.file="https://build.yunohost.org/"+infos.file; html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); @@ -413,17 +420,16 @@ $(document).ready(function () { }); - - - - - {% if not virtualbox %} {% if arm %} + ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image + {% else %} + ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image + {% endif %} Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %} @@ -457,16 +463,17 @@ Then run : # Replace /dev/mmcblk0 if the name of your device is different... dd if=/path/to/yunohost.img of=/dev/mmcblk0 ``` + [/ui-tab] {% if regular %} [ui-tab title="Burning a CD/DVD"] For older devices, you might want to burn a CD/DVD. The software to use depends on your operating system. -* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc +- On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc -* On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025) +- On macOS, use [Disk Utility](http://support.apple.com/kb/ph7025) -* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/) +- On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/) [/ui-tab] {% endif %} [/ui-tabs] @@ -485,34 +492,28 @@ For older devices, you might want to burn a CD/DVD. The software to use depends Go to **Settings** > **Network**: -* Select `Bridged adapter` -* Select your interface's name: +- Select `Bridged adapter` +- Select your interface's name: **wlan0** if you are connected wirelessly, or **eth0** otherwise. ![](image://virtualbox_2.png?class=inline) {% endif %} - - - - - - - - {% if arm %} + ## [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). -* 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 -* Wait a couple minutes while the board autoconfigure itself during the first boot -* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server. +- 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). +- 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 +- Wait a couple minutes while the board autoconfigure itself during the first boot +- Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server. {% elseif virtualbox %} + ## [fa=plug /] Boot up the virtual machine Start the virtual machine after selecting the YunoHost image. @@ -521,17 +522,18 @@ Start the virtual machine after selecting the YunoHost image. ! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer. - {% else %} + ## [fa=plug /] Boot the machine on your USB stick -* Plug the ethernet cable (one side on your main router, the other on your server). -* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific): +- Plug the ethernet cable (one side on your main router, the other on your server). +- Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific): ``, ``, ``, ``, `` or ``. - * N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options". + - N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options". {% endif %} {% if regular or virtualbox %} + ## [fa=rocket /] Launch the graphical install You should see a screen like this: @@ -554,9 +556,10 @@ You should see a screen like this: The YunoHost project simplified the classic installation as much as possible in order to avoid as many people as possible being lost with questions that are too technical or related to specific cases. -With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage). +With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage). + +### Summary of the steps in expert mode -### Summary of the steps in expert mode: 1. Select `Expert graphical install`. 2. Select your language, location, keyboard layout and possibly your timezone. 3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server. @@ -582,32 +585,39 @@ If you have one or more hard drives to store data, you can choose to mount it on If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage). ### About encryption + Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk"). ### About RAID + Keep in mind that: - * the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs) - * a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view - * hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array + +- the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs) +- a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view +- hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array [/ui-tab] [/ui-tabs] {% endif %} - {% if rpi012 %} + ## [fa=bug /] Connect to the board and hotfix the image + Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423). However, it is possible to fix by yourself the image before to run the initial configuration. To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`: + ``` ssh root@yunohost.local ``` + (or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network) Then run the following commands to work around the metronome issue: + ``` mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronomectl{,.bkp} @@ -616,13 +626,15 @@ ln -s /usr/bin/true /usr/bin/metronomectl ``` And this one to work around the upnpc issue: + ``` sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py ``` -! This last command need to be run after each yunohost upgrade :/ +! This last command need to be run after each YunoHost upgrade :/ {% elseif arm_unsup %} + ## [fa=terminal /] Connect to the board Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`. @@ -635,8 +647,8 @@ ssh root@192.168.x.xxx {% endif %} - {% if vps_debian or arm_unsup %} + ## [fa=rocket /] Run the install script - Open a command line prompt on your server (either directly or [through SSH](/ssh)) @@ -698,9 +710,9 @@ This will be the domain used by your server's users to access the **authenticati {% if not wsl %} -* If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration. +- If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration. -* If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config). +- If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config). !!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your **local** `/etc/hosts` file such that this dummy domain [points to the appropriate IP, as explained here](/dns_local_network). @@ -729,7 +741,6 @@ If you want to create subdomains, do not forget to add them in the `hosts` file This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username. - ## [fa=stethoscope /] Run the initial diagnosis Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created. @@ -757,10 +768,12 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial [/ui-tab] [ui-tab title="From the command line"] + ``` yunohost diagnosis run yunohost diagnosis show --issues --human-readable ``` + [/ui-tab] [/ui-tabs] @@ -781,9 +794,11 @@ Go in Domains > Click on your domain > SSL Certificate [/ui-tab] [ui-tab title="From the command line"] + ``` yunohost domain cert install ``` + [/ui-tab] [/ui-tabs] diff --git a/pages/02.administer/15.admin_guide/15.command_line/command_line.de.md b/pages/02.administer/15.admin_guide/15.command_line/command_line.de.md index ed35f399..760d9088 100644 --- a/pages/02.administer/15.admin_guide/15.command_line/command_line.de.md +++ b/pages/02.administer/15.admin_guide/15.command_line/command_line.de.md @@ -17,7 +17,7 @@ page-toc: ## Während der YunoHost Installation -#### Finde deine IP +### Finde deine IP Solltest du auf einem VPS installieren, dann hat der VPS Provider die IP-Adresse, die du bei ihm erfragen solltest. @@ -28,7 +28,7 @@ Wenn du Zuhause installierst (z.B. auf einem Raspberry Pi oder OLinuXino), dann - Prüfe die angezeigten Geräte in der Benutzeroberfläche deines Routers, ob du das Gerät findest; - Schließe einen Bildschirm und Tastatur an deinen Server, logge dich ein und tippe `hostname --all-ip-address`. -#### Verbinden +### Verbinden Angenommen deine IP Addresse ist `111.222.333.444`, öffne einen Terminal und gib Folgendes ein: @@ -40,11 +40,11 @@ Es wird nach einem Passwort gefragt. Handelt es sich um einen VPS, sollte der VP ! Seit YunoHost 3.4 kann man sich nach dem Ausführen der Postinstallation nicht mehr als `root` anmelden. **Stattdessen sollte man sich mit dem `admin` Benutzer anmelden!** Für den Fall, dass der LDAP-Server defekt und der `admin` Benutzer nicht verwendbar ist, kann man sich eventuell trotzdem noch mit `root` über das lokale Netzwerk anmelden. -#### Ändere das Passwort +### Ändere das Passwort Nach dem allerersten Login sollte man das root Passwort ändern. Der Server könnte dazu automatisch auffordern. Falls nicht, ist der Befehl `passwd` zu benutzen. Es ist wichtig, ein einigermaßen starkes Passwort zu wählen. Beachte, dass das root Passwort durch das admin Passwort überschrieben wird, wenn man die Postinstallation durchführt. -#### Auf ans Konfigurieren +### Auf ans Konfigurieren Wir sind nun bereit, mit der [Postinstallation](/postinstall) zu beginnen. @@ -108,11 +108,11 @@ Eine ausführlichere Diskussion über Sicherheit & SSH findest du auf der [dedic !!! Ein vollständiges Tutorial über die Kommandozeile würde den Rahmen der YunoHost-Dokumentation sprengen: Lies dazu am besten ein spezielles Tutorial wie [dieses](https://ryanstutorials.net/linuxtutorial/) oder [dieses](http://linuxcommand.org/). Aber sei versichert, dass du kein CLI-Experte sein musst, um es zu benutzen! -Der Befehl "yunohost" kann zur Verwaltung deines Servers verwendet werden und führt verschiedene Aktionen aus, die denen des Webadmin ähneln. Der Befehl muss entweder vom `root`-Benutzer oder vom `admin`-Benutzer durch Voranstellen von `sudo` gestartet werden. (ProTip™ : Du kannst `root` mit dem Befehl `sudo su` als `admin` werden). +Der Befehl "YunoHost" kann zur Verwaltung deines Servers verwendet werden und führt verschiedene Aktionen aus, die denen des Webadmin ähneln. Der Befehl muss entweder vom `root`-Benutzer oder vom `admin`-Benutzer durch Voranstellen von `sudo` gestartet werden. (ProTip™ : Du kannst `root` mit dem Befehl `sudo su` als `admin` werden). YunoHost-Befehle haben normalerweise diese Art von Struktur: -```test +```text yunohost app install wordpress --label Webmail ^ ^ ^ ^ | | | | diff --git a/pages/02.administer/15.admin_guide/15.command_line/command_line.es.md b/pages/02.administer/15.admin_guide/15.command_line/command_line.es.md index 4395ae63..ec5c0fec 100644 --- a/pages/02.administer/15.admin_guide/15.command_line/command_line.es.md +++ b/pages/02.administer/15.admin_guide/15.command_line/command_line.es.md @@ -19,7 +19,7 @@ La interfaz de línea de comandos (CLI) es, en informática, la manera original ## Durante la instalación de YunoHost -#### Encontrar su IP +### Encontrar su IP Si instalas YunoHost en un VPS, tu proveedor debería haberte comunicado la dirección IP de tu servidor. @@ -29,7 +29,7 @@ Si instalas un servidor en tu casa (por ejemplo en Raspberry Pi u OLinuXino), ti - utiliza la interfaz de tu router caja internet para listar las máquinas conectadas, o mira los los ; - conecta una pantalla en tu servidor, inicia una sesión y escribe `hostname --all-ip-address`. -#### Conectarse +### Conectarse Suponiendo que tu dirección IP sea `111.222.333.444`, abre una terminal y escribe : @@ -41,7 +41,7 @@ Ahora te piden una contraseña. Si es un VPS, tu proveedor ya te hará comunicad ! Desde YunoHost 3.4, después de la post-instalación ya no es posible conectarse con el usuario `root`. En lugar de eso, hace falta **conectarse con el usuario `admin`**. Incluso si el servidor LDAP fuera quebrado (haciendo que el usuario `admin` ya no fuera utilizable) todavía deberías poder conectarte con el usuario `root` desde la red local. -#### ¡ Cambiar la contraseña root +### ¡ Cambiar la contraseña root Después de haberte conectado por primera vez, tienes que cambiar la contraseña `root`. Tal vez el servidor te pida automáticamente que lo hagas. Si no es el caso, hay que utilizar el comando `passwd`. Es muy importante que elijas una contraseña bastante complicada. Nota que esta contraseña luego estará reemplazada por la contraseña admin elegida durante la post-instalación. diff --git a/pages/02.administer/15.admin_guide/15.command_line/command_line.it.md b/pages/02.administer/15.admin_guide/15.command_line/command_line.it.md index 2a61bae4..b394fb86 100644 --- a/pages/02.administer/15.admin_guide/15.command_line/command_line.it.md +++ b/pages/02.administer/15.admin_guide/15.command_line/command_line.it.md @@ -17,7 +17,7 @@ page-toc: ## Durante l'installazione di YunoHost -#### Individuare il proprio IP +### Individuare il proprio IP Se stai installando su un VPS allora il provider dovrebbe averti indicato il tuo indirizzo IP. @@ -27,7 +27,7 @@ Se stai installando su un computer casalingo (ad esempio un Raspberry Pi o un OL - usa l'interfaccia del router per vedere la lista dei computer collegati o controllane i log; - collega un monitor al tuo server YunoHost, fai login e digita `hostname --all-ip-address`. -#### Collegamento +### Collegamento Se come esempio il tuo indirizzo IP è `111.222.333.444` avvia un terminale e digita: @@ -39,7 +39,7 @@ Ti verrà richiesta una password. Nel caso tu stia utilizzando un VPS questa ti ! Dalla versione 3.4 di YunoHost, dopo aver completato il processo di post installazione, non sarà più possibile fare login da `root`: invece **sarà necessario fare login usando l'utente `admin`!**. Nel caso in cui il server LDAP non stia funzionando e l'utente `admin` sia inutilizzabile sarà sempre possibile fare login da `root` solo dalla rete locale. -#### Cambio della password +### Cambio della password Dopo esserci loggati per la prima volta è necessario cambiare la password di root e ti dovrebbe essere richiesto dal server stesso; nel caso in cui questo non accada usa il comando `passwd`. È importante scegliere una password ragionevolmente robusta. Nota che la password di root verrà sovrascritta dalla password di admin dal processo di postinstallazione. diff --git a/pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.fr.md b/pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.fr.md index e8cf522f..78ddac37 100644 --- a/pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.fr.md +++ b/pages/02.administer/15.admin_guide/20.users/05.groups_and_permissions/groups_and_permissions.fr.md @@ -25,7 +25,7 @@ Par défaut, deux groupes spéciaux sont créés : - `all_users`, qui contient tous les utilisateurs enregistrés sur YunoHost, - `visitors`, c'est-à-dire les personnes qui consultent le serveur sans être connectées. -- `admins`, apparut depuis Yunohost 11.1, ce groupe permet de gérer les administrateurs de la machine, chaque utilisateur aura alors (selon la configuration du serveur) accès en SSH ainsi que la webadmin. +- `admins`, apparut depuis YunoHost 11.1, ce groupe permet de gérer les administrateurs de la machine, chaque utilisateur aura alors (selon la configuration du serveur) accès en SSH ainsi que la webadmin. Vous ne pouvez pas changer le contenu de ces groupes, seulement les permissions qui leur sont accordées. diff --git a/pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.de.md b/pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.de.md index 55a8e748..884f0080 100644 --- a/pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.de.md +++ b/pages/02.administer/15.admin_guide/25.domains/01.certificate/certificate.de.md @@ -14,7 +14,7 @@ Und zwar, werden die Benutzer eine solche Warnung auf dem Bildschirm sehen: ![](image://postinstall_error_de.png) -Was im Wesentlichen den Besucher fragt: **"Vertrauen Sie dem Server, der diese Website hostet? "**. +Was im Wesentlichen den Besucher fragt: **"Vertrauen Sie dem Server, der diese Website hostet?"**. Dies kann viele Menschen selbstverständlich erschrecken. Um diese Verwirrung zu vermeiden, ist es möglich, ein digitales Zertifikat zu erhalten, welches direkt von den Browsern anerkannt wurde, und von einer "bekannten" Zertifizierungsstelle unterzeichnet wird: **Let's Encrypt**, **Gandi**, **RapidSSL**, **StartSSL**, **Cacert**. diff --git a/pages/02.administer/15.admin_guide/25.domains/domains.it.md b/pages/02.administer/15.admin_guide/25.domains/domains.it.md index 3402e1b1..f98b1b0c 100644 --- a/pages/02.administer/15.admin_guide/25.domains/domains.it.md +++ b/pages/02.administer/15.admin_guide/25.domains/domains.it.md @@ -7,7 +7,7 @@ routes: default: '/domains' --- -Yunohost permette l'installazione e la gestione di più domini sullo stesso server. Potrete quindi ospitare, ad esempio, un blog e una istanza Nextcloud sul dominio primario yolo.com, e un altro servizio su un secondo dominio swag.nohost.me. Ogni dominio viene automaticamente configurato affinché possa gestire i servizi web, le mail, e un servizio di chat XMPP. +YunoHost permette l'installazione e la gestione di più domini sullo stesso server. Potrete quindi ospitare, ad esempio, un blog e una istanza Nextcloud sul dominio primario yolo.com, e un altro servizio su un secondo dominio swag.nohost.me. Ogni dominio viene automaticamente configurato affinché possa gestire i servizi web, le mail, e un servizio di chat XMPP. I domini possono essere configurati a partire dalla sezione 'Domini' della pagina di amministrazione web, o attraverso la sezione `yunohost domain` da linea di comando. diff --git a/pages/02.administer/15.admin_guide/25.domains/domains.md b/pages/02.administer/15.admin_guide/25.domains/domains.md index 7cd41d23..bdffd650 100644 --- a/pages/02.administer/15.admin_guide/25.domains/domains.md +++ b/pages/02.administer/15.admin_guide/25.domains/domains.md @@ -21,7 +21,7 @@ Domains can be managed in the 'Domain' section of the webadmin, or through the ` ## 3 types of domains [ui-tabs position="top-left" active="0" theme="lite"] -[ui-tab title="Yunohost's domains (the free and easy way)"] +[ui-tab title="YunoHost's domains (the free and easy way)"] In order to make self-hosting as accessible as possible, the YunoHost Project provides a *free* and *automatically configured* domain name service. By using this service, you won't have to [configure DNS records](/dns_config) yourself, which can be tedious and technical. diff --git a/pages/02.administer/15.admin_guide/30.apps/apps.it.md b/pages/02.administer/15.admin_guide/30.apps/apps.it.md index 56e72f2d..f04aa27d 100644 --- a/pages/02.administer/15.admin_guide/30.apps/apps.it.md +++ b/pages/02.administer/15.admin_guide/30.apps/apps.it.md @@ -111,8 +111,8 @@ Da questa pagina è anche possibile eliminare l'applicazione. Dalla riga di comando è possibile cambiare: -* l'etichetta dell'applicazione nel sistema SSO: `yunohost app change-label ` -* l'url di connessione: `yunohost app change-url [-d ] [-p ]` +- l'etichetta dell'applicazione nel sistema SSO: `yunohost app change-label ` +- l'url di connessione: `yunohost app change-url [-d ] [-p ]` È anche possibile eliminare l'applicazione: `yunohost app remove ` diff --git a/pages/02.administer/15.admin_guide/30.apps/apps.md b/pages/02.administer/15.admin_guide/30.apps/apps.md index d846a5d0..169a3eed 100644 --- a/pages/02.administer/15.admin_guide/30.apps/apps.md +++ b/pages/02.administer/15.admin_guide/30.apps/apps.md @@ -107,8 +107,8 @@ You can also delete the application from this page. From the command line, you can change: -* the app's label in the SSO: `yunohost app change-label ` -* the app's url: `yunohost app change-url app [-d ] [-p ]` +- the app's label in the SSO: `yunohost app change-label ` +- the app's url: `yunohost app change-url app [-d ] [-p ]` You can also delete the app: `yunohost app remove ` diff --git a/pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md b/pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md index f539aded..c49187c2 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/15.buster_bullseye/buster_bullseye_migration.md @@ -96,7 +96,7 @@ yunohost app upgrade --force APP_NAME ### Can't run the migration due to `libc6-dev : Breaks: libgcc-8-dev issue` -Note: This issue should be resolved in yunohost_version: 4.4.2.13 +Note: This issue should be resolved in `yunohost_version`: `4.4.2.13` You have an app that depends on the `build-essential` package. See this [solution](https://forum.yunohost.org/t/migration-to-11-wont-start-libc6-dev-breaks-libgcc-8-dev/20617/42) to fix it manually diff --git a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md index dbc6cada..92d2fbdf 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.fr.md @@ -55,7 +55,7 @@ Pour cela, allez dans Outils > Diagnostique. (Vous pouvez aussi regarder ce qui ### Vérifiez que Fail2Ban et le pare-feu sont actifs -Vous devriez voir que Fail2Ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher 'fail2ban' et 'yunohost-firewall'). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`. +Vous devriez voir que Fail2Ban et le firewall sont actifs. Depuis la webadmin, dans Services (chercher `fail2ban` et `yunohost-firewall`). Depuis la ligne de commande, faites `yunohost service status fail2ban yunohost-firewall` : les deux devraient être en `active: active`. ### Vérifiez que les applications fonctionnent diff --git a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md index 23d6e430..fde3c32f 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/5.jessie_stretch_migration/jessie_stretch_migration.md @@ -55,7 +55,7 @@ You should be able to see this from the webadmin Tools > Diagnosis, and also in ### Check that Fail2Ban and the firewall are active -You should be able to see that Fail2Ban and the firewall are active. From the webadmin in Services (look for 'fail2ban' and 'yunohost-firewall'). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`. +You should be able to see that Fail2Ban and the firewall are active. From the webadmin in Services (look for `fail2ban` and `yunohost-firewall`). From the command line, run `yunohost service status fail2ban yunohost-firewall`. They should both have `active: active`. ### Check that your applications are working diff --git a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.fr.md b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.fr.md index e748cd92..26c7b69b 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.fr.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.fr.md @@ -19,7 +19,7 @@ Cliquez sur les boutons verts pour lancer les mises à jour du système et des a Voici quelques exemples en ligne de commande correspondants : -``` bash +```bash # Aller chercher les mises à jour disponibles yunohost tools update diff --git a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md index 8acb8a8a..05f4e021 100644 --- a/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md +++ b/pages/02.administer/15.admin_guide/55.upgrade/upgrade.md @@ -19,7 +19,7 @@ Click on green upgrade buttons to upgrade the system and applications. Here are some example of corresponding command lines: -``` bash +```bash # Fetch available updates yunohost tools update diff --git a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md index 0b6e3527..71be14b6 100644 --- a/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md +++ b/pages/02.administer/20.backups/10.backup_methods/01.borgbackup/borgbackup.it.md @@ -22,7 +22,7 @@ con BorgBackup potrete: - definire i tipi di dati da copiare e la frequenza di backup - ricevere una mail di allerta in caso di fallimento del backup -Oltre ai [fornitori terzi di repository](https://www.borgbackup.org/support/commercial.html), vi è la possibilità di hostare il proprio repository su una differente installazione yunohost con installata l'[applicazione borgserver](https://github.com/YunoHost-Apps/borgserver_ynh). +Oltre ai [fornitori terzi di repository](https://www.borgbackup.org/support/commercial.html), vi è la possibilità di hostare il proprio repository su una differente installazione YunoHost con installata l'[applicazione borgserver](https://github.com/YunoHost-Apps/borgserver_ynh). Il futuro metodo di backup integrato in YunoHost sarà basato su BorgBackup diff --git a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md b/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md index 940963c4..e4b3d96e 100644 --- a/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md +++ b/pages/02.administer/20.backups/10.backup_methods/03.archivist/archivist.md @@ -19,4 +19,4 @@ This application is based on rsync and GPG, it offers: The package also allows you to finely define the frequency and type of data to be backed up and integrates an email alert system in case of backup failure. -For more information: \ No newline at end of file +For more information: diff --git a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md index 3f562e37..c2bd4b78 100644 --- a/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md +++ b/pages/02.administer/20.backups/15.clone_filesystem/clone_filesystem.it.md @@ -12,7 +12,7 @@ page-toc: !! Images are missing on this page -Lo strumento di backup di Yunohost salva solamente i files utili e si basa su degli script di ripristino per reinstallare le dipendenze dei vostri programmi installati. In altre parole, il ripristino di YunoHost prevede in un primo tempo la reinstallazione del sistema e in seguito il ripristino dei dati. +Lo strumento di backup di YunoHost salva solamente i files utili e si basa su degli script di ripristino per reinstallare le dipendenze dei vostri programmi installati. In altre parole, il ripristino di YunoHost prevede in un primo tempo la reinstallazione del sistema e in seguito il ripristino dei dati. Realizzare un'immagine completa può essere un metodo, complementare o alternativo, per un backup del vostro server. Il vantaggio sta nel fatto che il vostro server può essere ripristinato nella stessa configurazione presente al momento del backup. diff --git a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.fr.md b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.fr.md index d0c4c975..ec9e10d8 100644 --- a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.fr.md +++ b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.fr.md @@ -51,11 +51,11 @@ Toutefois, ces techniques de grappes de disques ne devraient pas être considér Quelques exemples de situations connues des administrateurs systèmes professionnels: -* les disques d'une grappe montée avec des disques de la même marque peuvent tomber en panne quasiment en même temps en moins de quelques heures -* sans monitoring de la santé des disques, il y a de fortes chances que l'on ne remarque la panne d'un disque de la grappe que lorsqu'un deuxième tombe en panne (><) -* si on n'a pas de disque de rechange, le délai d'achat peut aboutir à un crash de l'autre disque -* un disque à moitié fonctionnel qui produit des erreurs peut propager son erreur à travers la grappe -* les connectiques des disques ou le contrôleur RAID peuvent produire des erreurs aussi ou tomber en panne -* plus on complexifie l'architecture avec de nombreux composants, plus il y a de chances que l'un d'eux tombe en panne +- les disques d'une grappe montée avec des disques de la même marque peuvent tomber en panne quasiment en même temps en moins de quelques heures +- sans monitoring de la santé des disques, il y a de fortes chances que l'on ne remarque la panne d'un disque de la grappe que lorsqu'un deuxième tombe en panne (><) +- si on n'a pas de disque de rechange, le délai d'achat peut aboutir à un crash de l'autre disque +- un disque à moitié fonctionnel qui produit des erreurs peut propager son erreur à travers la grappe +- les connectiques des disques ou le contrôleur RAID peuvent produire des erreurs aussi ou tomber en panne +- plus on complexifie l'architecture avec de nombreux composants, plus il y a de chances que l'un d'eux tombe en panne !!! Si vous souhaitez mettre en place une grappe RAID ou utiliser btrfs, le plus simple est de le faire à l'installation avec l'iso YunoHost en mode expert (lors du partitionnement du système). diff --git a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.it.md b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.it.md index 81f11fba..b4325629 100644 --- a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.it.md +++ b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.it.md @@ -52,11 +52,11 @@ Comunque i sistemi RAID non vanno considerati come metodi di backup. Un RAID dev Alcune situazioni ben conosciute dagli amministratori di sistema. -* i dischi di un cluster creato con dischi della stessa marca possono guastarsi quasi contemporaneamente nel giro di poche ore -* se non monitoriamo lo stato di salute dei nostri dischi, probabilmente ci accorgeremo di un problema ai dischi della configurazione RAID solo quando si guasterà un secondo disco (><) -* se non abbiamo un HD di scorta, nell'attesa che arrivi il disco nuovo per sostituire quello danneggiato, si guasterà anche l'altro -* un disco che non funziona correttamente può provocare errori in tutta la catena -* anche i controller RAID o i connettori possono guastarsi o dare errori -* più complessa è la nostra catena, maggiori sono le possibilità di un guasto +- i dischi di un cluster creato con dischi della stessa marca possono guastarsi quasi contemporaneamente nel giro di poche ore +- se non monitoriamo lo stato di salute dei nostri dischi, probabilmente ci accorgeremo di un problema ai dischi della configurazione RAID solo quando si guasterà un secondo disco (><) +- se non abbiamo un HD di scorta, nell'attesa che arrivi il disco nuovo per sostituire quello danneggiato, si guasterà anche l'altro +- un disco che non funziona correttamente può provocare errori in tutta la catena +- anche i controller RAID o i connettori possono guastarsi o dare errori +- più complessa è la nostra catena, maggiori sono le possibilità di un guasto !!! Se pianificate di creare una catena RAID o utilizzare il filesystem btrfs, la procedura più semplice è quella di installare YunoHost in modalità esperto (nella parte relativa alle partizioni del disco). diff --git a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md index bd80c79d..30fe81e5 100644 --- a/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md +++ b/pages/02.administer/20.backups/20.avoid_hardware_failure/avoid_hardware_failure.md @@ -52,11 +52,11 @@ However, these disk clustering techniques should not be considered as backups. A Some examples of situations known to professional system administrators: -* the disks of a cluster mounted with disks of the same brand can fail almost at the same time within a few hours -* without monitoring the health of the disks, there is a good chance that the failure of one disk in the cluster will only be noticed when a second one fails (><) -* if you don't have a spare disk, the delay in purchasing one may result in the other disk crashing -* a half-functional disk that produces errors can propagate its error through the cluster -* the disk connectors or the RAID controller can also produce errors or fail -* the more complex you make the architecture with many components, the more likely it is that one of them will fail +- the disks of a cluster mounted with disks of the same brand can fail almost at the same time within a few hours +- without monitoring the health of the disks, there is a good chance that the failure of one disk in the cluster will only be noticed when a second one fails (><) +- if you don't have a spare disk, the delay in purchasing one may result in the other disk crashing +- a half-functional disk that produces errors can propagate its error through the cluster +- the disk connectors or the RAID controller can also produce errors or fail +- the more complex you make the architecture with many components, the more likely it is that one of them will fail !!! If you want to set up a RAID array or use btrfs, the easiest way is to do it at installation with the YunoHost iso in expert mode (when partitioning the system). diff --git a/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.fr.md b/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.fr.md index cc215ee7..7e03aae7 100644 --- a/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.fr.md +++ b/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.fr.md @@ -20,7 +20,7 @@ yunohost backup create --method custom Ci-dessous, un exemple simpliste qui peut permettre de mettre en place un backup rotationnel avec différents disques que l'on change toutes les semaines: -/etc/yunohost/hooks.d/backup_method/05-custom +`/etc/yunohost/hooks.d/backup_method/05-custom` ```bash #!/bin/bash diff --git a/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.it.md b/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.it.md index f1d9aa6d..7ff8bbc7 100644 --- a/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.it.md +++ b/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.it.md @@ -21,7 +21,7 @@ yunohost backup create --method custom Di seguito un esempio, semplificato, che esegue il backup con rotazione dei dischi, che vengono sostituiti ogni settimana. -/etc/yunohost/hooks.d/backup_method/05-custom +`/etc/yunohost/hooks.d/backup_method/05-custom` ```bash #!/bin/bash diff --git a/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.md b/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.md index 945a907c..b79a067e 100644 --- a/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.md +++ b/pages/02.administer/20.backups/30.custom_backup_methods/custom_backup_methods.md @@ -21,7 +21,7 @@ yunohost backup create --method custom Below is a simplistic example that can be used to set up a rotational backup with different disks that are changed every week: -/etc/yunohost/hooks.d/backup_method/05-custom +`/etc/yunohost/hooks.d/backup_method/05-custom` ```bash #!/bin/bash diff --git a/pages/02.administer/45.tutorials/05.domains/01.dns_nohost_me/dns_nohost_me.md b/pages/02.administer/45.tutorials/05.domains/01.dns_nohost_me/dns_nohost_me.md index 720e4c9d..b8773e5e 100644 --- a/pages/02.administer/45.tutorials/05.domains/01.dns_nohost_me/dns_nohost_me.md +++ b/pages/02.administer/45.tutorials/05.domains/01.dns_nohost_me/dns_nohost_me.md @@ -23,7 +23,7 @@ To use this service, you simply have to choose such a domain during the post-ins The `nohost.me`, `noho.st` and `ynh.fr` domain service allows the creation of subdomains. -YunoHost allows the installation of applications on subdomains (for example, having the Nextcloud application accessible from the `cloud.mydomain.org` address), this feature is also allowed with the `nohost.me`, `noho.st` and `ynh.fr` domains and so it is possible to have a subdomain such as `my.application.mydomain.nohost.me`. To create a subdomain on `nohost.me`, `noho.st` and `ynh.fr`, you just have to add the subdomain to yunohost like any other domains. +YunoHost allows the installation of applications on subdomains (for example, having the Nextcloud application accessible from the `cloud.mydomain.org` address), this feature is also allowed with the `nohost.me`, `noho.st` and `ynh.fr` domains and so it is possible to have a subdomain such as `my.application.mydomain.nohost.me`. To create a subdomain on `nohost.me`, `noho.st` and `ynh.fr`, you just have to add the subdomain to YunoHost like any other domains. ### Adding a nohost.me, noho.st or ynh.fr domain after the post-installation diff --git a/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.fr.md b/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.fr.md index 8d9b3579..e89660aa 100644 --- a/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.fr.md +++ b/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.fr.md @@ -7,7 +7,7 @@ routes: default: '/dns_dynamicip' --- -! Avant d’aller plus loin, assurez-vous que votre adresse IP publique est dynamique à l’aide de : [ip.yunohost.org](http://ip.yunohost.org/). L’adresse IP publique de votre box change à peu près tous les jours. +! Avant d’aller plus loin, assurez-vous que votre adresse IP publique est dynamique à l’aide de : [`ip.yunohost.org`](http://ip.yunohost.org/). L’adresse IP publique de votre box change à peu près tous les jours. Ce tutoriel a pour but de contourner le problème d’IP dynamique qui est le suivant : lorsque l’adresse IP publique de la box change, la zone DNS n’est pas mise à jour pour pointer vers la nouvelle adresse IP. diff --git a/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.it.md b/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.it.md index 8aadd30b..02b9563b 100644 --- a/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.it.md +++ b/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.it.md @@ -7,7 +7,7 @@ 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. +! 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. diff --git a/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.md b/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.md index 87550416..0ce7e7e2 100644 --- a/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.md +++ b/pages/02.administer/45.tutorials/05.domains/02.dns_dynamic_ip/dns_dynamicip.md @@ -7,7 +7,7 @@ routes: default: '/dns_dynamicip' --- -! Before going further, make sure your global IP address is dynamic with: [ip.yunohost.org](http://ip.yunohost.org/). The global IP address of your box changes almost every day. +! Before going further, make sure your global IP address is dynamic with: [`ip.yunohost.org`](http://ip.yunohost.org/). The global IP address of your box changes almost every day. This tutorial aim to get around dynamic IP issue which is: when the IP public address of your (Internet Service Provider-) box changes, the DNS zone is not updated to point towards the new IP address, and consequently your server is no more reachable via its domain name diff --git a/pages/02.administer/45.tutorials/15.filezilla/filezilla.fr.md b/pages/02.administer/45.tutorials/15.filezilla/filezilla.fr.md index 464bf5c8..e50ddcc4 100644 --- a/pages/02.administer/45.tutorials/15.filezilla/filezilla.fr.md +++ b/pages/02.administer/45.tutorials/15.filezilla/filezilla.fr.md @@ -55,12 +55,12 @@ Installez le programme et lancez *Filezilla*. ![Copier les sauvegardes de YunoHost sur l'ordinateur local](image://filezilla_8.png) ----- +--- Sources -* [Documentation officielle](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(fr)) -* [Tutoriel général à Filezilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/) +- [Documentation officielle](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(fr)) +- [Tutoriel général à Filezilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/) ## Alternatives à Filezilla @@ -70,14 +70,14 @@ Depuis n'importe quel GNU/Linux récent, vous devriez pouvoir utiliser le gestio Nautilus de Gnome3 et Dolphin de KDE intègrent de base des fonctionnalités similaires à FileZilla : -* -* -* +- +- +- ### Sous Windows -* [WinSCP](https://winscp.net/) est aussi un bon candidat pour Windows +- [WinSCP](https://winscp.net/) est aussi un bon candidat pour Windows ### Sous macOS -* [Cyberduck](https://cyberduck.io/) logiciel libre pour macOS +- [Cyberduck](https://cyberduck.io/) logiciel libre pour macOS diff --git a/pages/02.administer/45.tutorials/15.filezilla/filezilla.it.md b/pages/02.administer/45.tutorials/15.filezilla/filezilla.it.md index 11486445..152bee88 100644 --- a/pages/02.administer/45.tutorials/15.filezilla/filezilla.it.md +++ b/pages/02.administer/45.tutorials/15.filezilla/filezilla.it.md @@ -55,7 +55,7 @@ Installate e lanciate *FileZilla* ![Copia dei backup da YunoHost ad un computer locale](image://filezilla_8.png) ----- +--- Link a fonti esterne: @@ -70,8 +70,8 @@ Qualsiasi distribuzione recente di GNU/Linux dovrebbe permettere di accedere al Nautilus di Gnome3 integra delle funzionalità simili a FileZilla: -* -* +- +- ### Windows diff --git a/pages/02.administer/45.tutorials/15.filezilla/filezilla.md b/pages/02.administer/45.tutorials/15.filezilla/filezilla.md index 8f191f46..a43d3984 100644 --- a/pages/02.administer/45.tutorials/15.filezilla/filezilla.md +++ b/pages/02.administer/45.tutorials/15.filezilla/filezilla.md @@ -55,12 +55,12 @@ Install the program and run *Filezilla*. ![Copy backups from YunoHost to local computer](image://filezilla_8.png) ----- +--- Sources -* [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en)) -* [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/) +- [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en)) +- [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/) ## Alternatives to Filezilla @@ -70,14 +70,14 @@ From any recent GNU/Linux, you should be able to use the `file manager` to reach Nautilus from Gnome3 and Dolphin from KDE have features similar to FileZilla, out of the box. -* -* -* +- +- +- ### Windows -* [WinSCP](https://winscp.net/) is also a nice candidate for Windows +- [WinSCP](https://winscp.net/) is also a nice candidate for Windows ### macOS -* [Cyberduck](https://cyberduck.io/) is a free software available on macOS +- [Cyberduck](https://cyberduck.io/) is a free software available on macOS diff --git a/pages/02.administer/45.tutorials/25.external_storage/external_storage.fr.md b/pages/02.administer/45.tutorials/25.external_storage/external_storage.fr.md index cb450f70..e04765b7 100644 --- a/pages/02.administer/45.tutorials/25.external_storage/external_storage.fr.md +++ b/pages/02.administer/45.tutorials/25.external_storage/external_storage.fr.md @@ -23,15 +23,15 @@ Ci-dessous, vous trouverez des explications pour parvenir à déplacer vos donn ## [fa=list-alt /] Pré-requis -* Avoir un peu de temps à un moment où les utilisateurs de votre serveur peuvent accepter un arrêt des services. Les étapes à réaliser, même si elles sont relativement simples, peuvent parfois paraître techniques et nécessitent dans tous les cas **de prendre son temps**. +- Avoir un peu de temps à un moment où les utilisateurs de votre serveur peuvent accepter un arrêt des services. Les étapes à réaliser, même si elles sont relativement simples, peuvent parfois paraître techniques et nécessitent dans tous les cas **de prendre son temps**. -* Savoir se connecter en root sur votre système, par exemple via [SSH](/ssh). (Note : en étant connecté en tant qu'utilisateur `admin`, vous pouvez passer root avec `sudo su`) +- Savoir se connecter en root sur votre système, par exemple via [SSH](/ssh). (Note : en étant connecté en tant qu'utilisateur `admin`, vous pouvez passer root avec `sudo su`) -* Connaître les commandes basiques `cd`, `ls`, `mkdir`, `rm` +- Connaître les commandes basiques `cd`, `ls`, `mkdir`, `rm` -* Avoir une sauvegarde au cas où ça ne se passe pas comme prévu +- Avoir une sauvegarde au cas où ça ne se passe pas comme prévu -* Disposer d'un stockage supplémentaire (disque SSD, disque dur, clé USB) branché à votre serveur en USB ou en SATA +- Disposer d'un stockage supplémentaire (disque SSD, disque dur, clé USB) branché à votre serveur en USB ou en SATA ## 1. Identifier les dossiers à déplacer @@ -43,7 +43,7 @@ Ci-dessous, une explication de certains chemins qui peuvent prendre du poids ave |--------|---|---| | `/home` | Dossiers utilisateurs accessibles via SFTP | Déplaçable sur un disque dur | | `/home/yunohost.backup` | Sauvegardes YunoHost | Selon votre stratégie de sauvegarde, il peut être préférable de placer ce dossier sur un disque distinct de celui où se trouvent vos données ou vos bases de données | -| `/home/yunohost.app` | Données lourdes des applications yunohost (nextcloud, matrix...) | Déplaçable sur un disque dur | +| `/home/yunohost.app` | Données lourdes des applications YunoHost (nextcloud, matrix...) | Déplaçable sur un disque dur | | `/home/yunohost.multimedia` | Données lourdes partagées entre plusieurs applications | Déplaçable sur un disque dur | | `/var/lib/mysql` | Base de données utilisées par les applications | A laisser idéalement sur le SSD pour des raisons de performances | | `/var/lib/postgresql` | Base de données utilisées par les applications | A laisser idéalement sur le SSD pour des raisons de performances | diff --git a/pages/02.administer/45.tutorials/25.external_storage/external_storage.it.md b/pages/02.administer/45.tutorials/25.external_storage/external_storage.it.md index fec75146..2eca1f14 100644 --- a/pages/02.administer/45.tutorials/25.external_storage/external_storage.it.md +++ b/pages/02.administer/45.tutorials/25.external_storage/external_storage.it.md @@ -23,15 +23,15 @@ Troverete qui le istruzioni per riuscire a spostare i vostri dati su un disco es ## [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**. +- 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`) +- 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`. +- Conoscere i comandi `cd`, `ls`, `mkdir`, `rm`. -* Disporre di un backup nel caso le cose non vadano come previsto +- 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 +- Disporre di un disco aggiuntivo (SSD, hard disk, chiavetta USB) collegato al server via USB o SATA ## 1. Identificare le cartelle da spostare diff --git a/pages/02.administer/45.tutorials/25.external_storage/external_storage.md b/pages/02.administer/45.tutorials/25.external_storage/external_storage.md index a75aaa91..6f7118b6 100644 --- a/pages/02.administer/45.tutorials/25.external_storage/external_storage.md +++ b/pages/02.administer/45.tutorials/25.external_storage/external_storage.md @@ -23,15 +23,15 @@ Below you will find explanations on how to move your data to a hard disk in a co ## [fa=list-alt /] Prerequisites -* Have some time at a moment when your server users can accept a shutdown. The steps to be performed, even if they are relatively simple, can sometimes seem technical and require in any case **to take your time**. +- Have some time at a moment when your server users can accept a shutdown. The steps to be performed, even if they are relatively simple, can sometimes seem technical and require in any case **to take your time**. -* Know how to connect as root on your system, for example via [SSH](/ssh). (Note: while logged in as `admin`, you can root with `sudo su`) +- Know how to connect as root on your system, for example via [SSH](/ssh). (Note: while logged in as `admin`, you can root with `sudo su`) -* Know the basic commands `cd`, `ls`, `mkdir`, `rm`. +- Know the basic commands `cd`, `ls`, `mkdir`, `rm`. -* Have a backup in case things don't work out as planned +- Have a backup in case things don't work out as planned -* Have extra storage (SSD, hard drive, USB stick) connected to your server via USB or SATA +- Have extra storage (SSD, hard drive, USB stick) connected to your server via USB or SATA ## 1. Identify directories to be moved @@ -43,7 +43,7 @@ Below is an explanation of some of the paths that can take up weight with some c |--------|---|---| | `/home` | User folders accessible via SFTP | Moveable to a hard disk | | `/home/yunohost.backup` | YunoHost's backups | Depending on your backup strategy, you may want to place this folder on a separate drive from your data or databases. -| `/home/yunohost.app` |Heavy data from yunohost applications (nextcloud, matrix...)|Moveable to a hard disk +| `/home/yunohost.app` |Heavy data from YunoHost applications (nextcloud, matrix...)|Moveable to a hard disk | `/home/yunohost.multimedia` | Heavy data shared between several applications | Moveable to a hard disk | | `/var/lib/mysql` | Database used by applications | Ideally leave on SSD for performance reasons | | `/var/lib/postgresql` | Database used by applications | Ideally leave on SSD for performance reasons | @@ -127,9 +127,9 @@ mount /dev/YOUR_DISK1 /mnt/hdd (Here, `/dev/YOUR_DISK1` corresponds to the first partition on the disk) -## 5. Mount a /mnt/hdd folder on one of the folders you want to move data from +## 5. Mount a `/mnt/hdd` folder on one of the folders you want to move data from -Here we will consider that you want to move the big data of the applications which are in /home/yunohost.app and the mails on your hard disk. +Here we will consider that you want to move the big data of the applications which are in `/home/yunohost.app` and the mails on your hard disk. ### 5.1 Creating subfolders on the disk diff --git a/pages/02.administer/45.tutorials/40.tor/torhiddenservice.fr.md b/pages/02.administer/45.tutorials/40.tor/torhiddenservice.fr.md index 4d586aa9..f97d9c75 100644 --- a/pages/02.administer/45.tutorials/40.tor/torhiddenservice.fr.md +++ b/pages/02.administer/45.tutorials/40.tor/torhiddenservice.fr.md @@ -7,7 +7,7 @@ routes: default: '/torhiddenservice' --- -! Ce tuto n'est pas complet ! Des données peuvent être récupérées avec cette installation comme le nom de domaine principal de votre yunohost, donc ce n'est pas un "service caché". Voir (anglais) +! Ce tuto n'est pas complet ! Des données peuvent être récupérées avec cette installation comme le nom de domaine principal de votre YunoHost, donc ce n'est pas un "service caché". Voir (anglais) ### Installer Tor diff --git a/pages/02.administer/45.tutorials/40.tor/torhiddenservice.it.md b/pages/02.administer/45.tutorials/40.tor/torhiddenservice.it.md index 77b5d2f4..658b8264 100644 --- a/pages/02.administer/45.tutorials/40.tor/torhiddenservice.it.md +++ b/pages/02.administer/45.tutorials/40.tor/torhiddenservice.it.md @@ -7,7 +7,7 @@ routes: default: '/torhiddenservice' --- -! Questo tutorial non è completo! Con queste impostazioni alcuni dati possono essere rivelati come ad esempio il dominio principale del tuo yunohost, di conseguenza non può essere considerato un reale "Hidden service". Vedi +! Questo tutorial non è completo! Con queste impostazioni alcuni dati possono essere rivelati come ad esempio il dominio principale del tuo YunoHost, di conseguenza non può essere considerato un reale "Hidden service". Vedi ### Installare Tor diff --git a/pages/02.administer/45.tutorials/40.tor/torhiddenservice.md b/pages/02.administer/45.tutorials/40.tor/torhiddenservice.md index ce5838b8..1188289a 100644 --- a/pages/02.administer/45.tutorials/40.tor/torhiddenservice.md +++ b/pages/02.administer/45.tutorials/40.tor/torhiddenservice.md @@ -7,7 +7,7 @@ routes: default: '/torhiddenservice' --- -! This tuto is not finished ! Some data could leak with this setup like the main domain of your yunohost, so it's not a "Hidden Service". See +! This tuto is not finished ! Some data could leak with this setup like the main domain of your YunoHost, so it's not a "Hidden Service". See ###  Installing Tor diff --git a/pages/02.administer/45.tutorials/45.certificate_custom/certificate_custom.fr.md b/pages/02.administer/45.tutorials/45.certificate_custom/certificate_custom.fr.md index 3a591c71..9860165f 100644 --- a/pages/02.administer/45.tutorials/45.certificate_custom/certificate_custom.fr.md +++ b/pages/02.administer/45.tutorials/45.certificate_custom/certificate_custom.fr.md @@ -11,8 +11,8 @@ routes: Quelques changements ont eu lieu qui impactent les procédures indiquées ci-dessous : -* Le groupe metronome n'est plus utilisé directement mais ssl-cert. -* Un repertoire `/etc/yunohost/certs/DOMAIN.LTD-history/stamp` est utilisé pour conserver chaque configuration créée et un lien symbolique est créé dessus. +- Le groupe metronome n'est plus utilisé directement mais ssl-cert. +- Un repertoire `/etc/yunohost/certs/DOMAIN.LTD-history/stamp` est utilisé pour conserver chaque configuration créée et un lien symbolique est créé dessus. ### Ajout d’un certificat signé par une autorité (autre que Let's Encrypt) @@ -103,7 +103,7 @@ cat crt.pem key.pem Les certificats et la clé privée doivent ressembler à cela : -```plaintext +```text -----BEGIN CERTIFICATE----- MIICVDCCAb0CAQEwDQYJKoZIhvcNAQEEBQAwdDELMAkGA1UEBhMCRlIxFTATBgNV BAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UEChMDTExC @@ -142,4 +142,4 @@ Rechargez la configuration de NGINX pour prendre en compte le nouveau certificat sudo service nginx reload ``` -Votre certificat est prêt à servir. Vous pouvez toutefois vous assurer de sa mise en place en testant le certificat à l’aide du service de ). Si cela ne fonctionne pas: @@ -21,9 +21,9 @@ Vérifier que vous arrivez à accéder au serveur en utilisant son IP globale (q - Certaines box de FAI ne supportent pas le hairpinning et vous ne pouvez pas accéder à votre serveur depuis l'intérieur du réseau local (sauf à passer par l'IP locale). Pour contourner le problème, vous pouvez utiliser un des moyens suivants: - utiliser une connexion cellulaire (4/5G) - modifier le fichier /etc/hosts sur vos équipements - - déclarer l'ip locale de yunohost comme resolveur DNS dans votre routeur (partie DHCP) et ouvrir le port 53 UDP sur votre yunohost en faisant attention de ne pas activer l'upnp sur le port 53. Surtout, n'ouvrez pas le port 53 de votre routeur. + - déclarer l'ip locale de YunoHost comme resolveur DNS dans votre routeur (partie DHCP) et ouvrir le port 53 UDP sur votre YunoHost en faisant attention de ne pas activer l'upnp sur le port 53. Surtout, n'ouvrez pas le port 53 de votre routeur. -#### Il faut configurer vos enregistrement DNS +### Il faut configurer vos enregistrement DNS (N.B.: ce n'est pas nécessaire si vous utilisez un domaine de type nohost.me, noho.st ou ynh.fr) @@ -31,7 +31,7 @@ Il vous faut configurer vos enregistrement DNS comme expliqué sur [cette page]( Vous pouvez valider que les enregistrements DNS sont corrects en comparant le résultat de avec l'IP globale de votre serveur (si vous êtes hébergé à la maison, vous pouvez obtenir cette IP sur ) -#### Autres causes possibles +### Autres causes possibles - Votre nom de domaine noho.st, nohost.me ou ynh.fr est inaccessible suite à une panne de l'infra YunoHost. Vérifiez sur le forum si d'autre personnes signalent le même problème. - Votre nom de domaine est peut-être expiré. Vous pouvez vérifier que votre nom de domaine a expiré en vous connectant sur l'interface de votre registrar ou en utilisant le whois par exemple via la commande `whois NOM_DE_DOMAINE`. @@ -45,13 +45,13 @@ Une erreur de certificat peut également être affichée dans certain cas où vo ## Vous avez accès en SSH mais pas à la Web admin ou inversement -#### Vous essayez de vous connecter en SSH avec `root` plutôt qu'avec `admin` +### Vous essayez de vous connecter en SSH avec `root` plutôt qu'avec `admin` Par défaut, la connexion en SSH doit s'effectuer avec l'utilisateur `admin`. Il est possible de se connecter à la machine avec l'utilisateur `root` *seulement depuis le réseau local* sur lequel se situe le serveur (ou bien via la console web / VNC pour des VPS). Lorsque vous exécutez des commandes `yunohost` en tant qu'admin, il faut les précéder de la commande `sudo` (par exemple `sudo yunohost user list`). Vous pouvez également devenir `root` en tapant `sudo su`. -#### Vous avez été banni temporairement +### Vous avez été banni temporairement Votre serveur YunoHost inclut un mécanisme (Fail2Ban) qui banni automatiquement les IPs qui échouent plusieurs fois à s'authentifier. Dans certains cas, il peut s'agir d'un programme (par exemple un client Nextcloud) qui est configuré avec un ancien mot de passe ou d'un utilisateur qui utilise la même IP que vous. @@ -63,7 +63,7 @@ Voir aussi : [débannir une IP sur Fail2Ban](/fail2ban) NB : le bannissement dure en général 10 à 12 minutes. Le bannissement n'est actif qu'en IPv4. -#### Le serveur web NGINX est cassé +### Le serveur web NGINX est cassé Peut-être que le serveur web NGINX est en panne. Vous pouvez vérifier cela [en ssh](/ssh) avec `yunohost service status nginx`. Si il est en panne, vérifiez que la configuration ne comporte pas d'erreur avec `nginx -t`. Si la configuration est cassée, ceci est peut-être du à une l'installation ou désinstallation d'une application de mauvaise qualité... Si vous êtes perdu, [demandez de l'aide](/help). @@ -73,7 +73,7 @@ Il se peut également que le serveur web (NGINX) ou le serveur ssh aient été t - Vous pouvez contrôler l'espace disque utilisé avec `df -h`. Si une de vos partitions est remplie à 100%, il faut identifier ce qui prend de la place sur votre système et faire de la place. Il est possible d'installer l'utilitaire `ncdu` avec `apt install ncdu` puis de faire `ncdu /` pour analyser la taille des dossiers de toute l'arborescence. - Vous pouvez contrôler l'utilisation de la RAM / swap avec `free -h`. En fonction des résultats, il peut être nécessaire d'optimiser votre serveur pour qu'il utilise moins de RAM (suppression d'app lourdes et inutiles...), d'ajouter de la RAM ou d'ajouter un fichier de swap. -#### Votre serveur est accessible en IPv6 mais pas en IPv4 ou inversement +### Votre serveur est accessible en IPv6 mais pas en IPv4 ou inversement Vous pouvez le vérifier en tentant de faire des ping sur votre serveur en IPv4 et en IPv6. diff --git a/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.it.md b/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.it.md index b7c67942..2c7ddda4 100644 --- a/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.it.md +++ b/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.it.md @@ -13,14 +13,14 @@ Questa pagina cercherà di trovare il problema, riottenere l'accesso ed eventual ## Hai l'accesso al server usando l'indirizzo IP locale ma non dal nome di dominio -#### Se il server è self-hosted a casa: controlla il port forwarding +### Se il server è self-hosted a casa: controlla il port forwarding Controlla di riuscire ad accedere al server usando l'IP pubblico (lo puoi trovare su [https://ip.yunohost.org](https://ip.yunohost.org)). Se questo non funziona: - Assicurati di aver [impostato il forwarding](/isp_box_config). - Alcuni ISP non supportano l'*hairpinning*, cosa che ti impedirà di raggiungere il tuo server dal nome di dominio dalla rete locale. Nel caso puoi usare una connessione cellulare o modificare il file `hosts` del tuo computer in modo da associare il nome di dominio all'indirizzo IP locale invece che a quello pubblico. -#### Configura i record DNS +### Configura i record DNS ! Questo non è un problema se stai usando un dominio fornito da `nohost.me`, `noho.st` or `ynh.fr` @@ -28,7 +28,7 @@ Devi configurare i tuoi [record DNS](/dns_config) (come minimo i record `A` e `A Puoi verificare la correttezza dei record DNS confrontando i risultati dati da [questo servizio](https://www.whatsmydns.net/) con l'[IP restituito dal nostro servizio](https://ip.yunohost.org). -#### Altre probabili cause +### Altre probabili cause - Il tuo dominio `noho.st`, `nohost.me` o `ynh.fr` non è raggiungibile a causa di un problema nell'infrastruttura di YunoHost. Controlla il [forum](https://forum.yunohost.org/) per annunci o post di persone relativi allo stesso problema. - Il tuo nome di dominio potrebbe essere scaduto. Controlla la pagina del registrar usato per la registrazione oppure usa il comando `whois yourdomain.tld`. @@ -42,13 +42,13 @@ Puoi verificare la correttezza dei record DNS confrontando i risultati dati da [ ## Puoi accedere via SSH ma non dalla pagina di amministrazione o l'inverso -#### Stai provando a loggarti via SSH come `root` invece che con l'utente `admin` +### Stai provando a loggarti via SSH come `root` invece che con l'utente `admin` Di default è possibile loggarsi via SSH solo come `admin`. È possibile loggarsi come `root` *solo dall'interno della rete locale del server*. Se il server è su una VPS la console web o VNC fornita dal provider DPS dovrebbe funzionare. Se stai provando ad avviare i comandi `yunohost` dalla riga di comando come `admin` è necessario avviarlo preceduto dal comando `sudo` (ad esempio `sudo yunohost user list`). È possibile diventare `root` anche con il comando `sudo su`. -#### Sei stato bannato temporaneamente +### Sei stato bannato temporaneamente Il tuo server YunoHost include il servizio Fail2Ban che banna automaticamente gli indirizzi IP che falliscono più volte di seguito. In alcuni casi possono essere programmi configurati con password vecchie (ad esempio client Nextcloud) oppure un utente che ha il tuo stesso IP. @@ -60,7 +60,7 @@ Vedi anche: [togliere il ban ad un indirizzo](/fail2ban) !!!! I ban normalmente durano dai 0 ai 12 minuti e solo su IPv4. -#### Il server web NGINX non funziona +### Il server web NGINX non funziona Può essere che il server web NGINX non stia funzionando. @@ -72,7 +72,7 @@ The NGINX or SSH servers may have been killed due to a lack of storage space, RA - You can check used storage with `df -h`. If one of your partitions is full, you need to identify what fills it and make rooù. You can use `ncdu` command (install it with `apt install ncdu` to browse from the root directory: `ncdu /` - You can check RAM and swap usage with `free -h`. Depending on the result, it may be necessary to optimize your server to use less RAM (removal of heavy or unused apps...), add more RAM or add a swap file. -#### Your server is reachable by IPv6, but not IPv4, or inversely +### Your server is reachable by IPv6, but not IPv4, or inversely You can check that by `ping`ing it: diff --git a/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.md b/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.md index 9b05505f..0e325371 100644 --- a/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.md +++ b/pages/02.administer/50.troubleshooting/15.noaccess/noaccess.md @@ -13,14 +13,14 @@ This page will help you diagnose the issue, get back access, and if needed repai ## You have access to the server with its local IP address, but not its domain name -#### If you are self-hosted at home: fix ports forwarding +### If you are self-hosted at home: fix ports forwarding Check that you are getting access to the server by using its public IP (you can find at [https://ip.yunohost.org](https://ip.yunohost.org). If this does not work: - Make sure you have [set up forwarding](/isp_box_config) - Some ISP routers do not support *hairpinning*, which prevents you from reaching your server by its domain name from within your local network. If so, you can use a cellular connection, or tweak your `hosts` file on your computer to make it bind your domain name to the local IP address instead of the public one. -#### Configure DNS records +### Configure DNS records ! This is not a problem if you are using a domain from `nohost.me`, `noho.st` or `ynh.fr`) @@ -28,7 +28,7 @@ You have to configure your [DNS records](/dns_config) (at least `A` records, and You can check that the DNS records are correct by comparing the results given by [this service](https://www.whatsmydns.net/) with the [IP given by our service](https://ip.yunohost.org). -#### Other probable causes +### Other probable causes - You domain `noho.st`, `nohost.me`, or `ynh.fr` is unreachable following a failure on YunoHost's infrastructure. Check the [forum](https://forum.yunohost.org/) for announcements or people posting about the same issue. - Your domain name may be expired. Check that on your registrar's client panel, or by using the command `whois yourdomain.tld`. @@ -42,13 +42,13 @@ You can check that the DNS records are correct by comparing the results given by ## You have access via SSH but not via the webadmin, or inversely -#### You are trying to log in with SSH as `root` instead of `admin` user +### You are trying to log in with SSH as `root` instead of `admin` user By default, SSH connection has to be made as `admin`. It possible to log into the server as `root` *only from the local network of the server*. If your server is a VPS, the web console or VNC provided by VPS providers may work. If you are running `yunohost` commands in the CLI as `admin`, you have to call them with `sudo` before (for example `sudo yunohost user list`). You can also become `root` by running `sudo su`. -#### You have been temporarily banned +### You have been temporarily banned Your YunoHost server includes a service, Fail2ban, which automatically bans IPs that fail several times in a row to log in. In some cases it can be software (e.g. Nextcloud client) that are confifured with an old password, or a user who has the same IP as you have. @@ -60,7 +60,7 @@ See also : [unban an IP on Fail2Ban](/fail2ban) !!!! Ban are usually 10 to 12-minute-long, and on IPv4 only. -#### NGINX web server is broken +### NGINX web server is broken Maybe the NGINX web server is out of order. You can check that [trough SSH](/ssh) with the command `yunohost service status nginx`. If it is failing, check that its configuration is correct by running `nginx -t`. If it is indeed broken, it may be due to the installation or removal of a low-quality app... If you need support, [ask for it](/help). @@ -70,7 +70,7 @@ The NGINX or SSH servers may have been killed due to a lack of storage space, RA - You can check used storage with `df -h`. If one of your partitions is full, you need to identify what fills it and make room. You can use `ncdu` command (install it with `apt install ncdu` to browse from the root directory: `ncdu /` - You can check RAM and swap usage with `free -h`. Depending on the result, it may be necessary to optimize your server to use less RAM (removal of heavy or unused apps...), add more RAM or add a swap file. -#### Your server is reachable by IPv6, but not IPv4, or inversely +### Your server is reachable by IPv6, but not IPv4, or inversely You can check that by `ping`ing it: diff --git a/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.fr.md b/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.fr.md index e98e4aca..8ae0531f 100644 --- a/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.fr.md +++ b/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.fr.md @@ -45,7 +45,7 @@ ddclient annonce à OVH le changement d’IP. OVH va alors changer votre IP. Il faut ajouter dans le fichier de configuration : -* votre identifiant et votre mot de passe DynHost -* votre nom de domaine +- votre identifiant et votre mot de passe DynHost +- votre nom de domaine Il existe un [guide d'utilisation DynHost fait par OVH](https://docs.ovh.com/fr/fr/web/domains/utilisation-dynhost/). diff --git a/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.it.md b/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.it.md index 69385a98..1cd95631 100644 --- a/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.it.md +++ b/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.it.md @@ -47,7 +47,7 @@ ddclient si occuperà di avvisare OVH quando il vostro IP cambierà e OVH adatte Nel file di configurazione di ddclient dovrete aggiungere: -* il vostro user e la vostra password DynHost -* il nome del vostro dominio +- il vostro user e la vostra password DynHost +- il nome del vostro dominio Seguite anche questa [guida creata da OVH](https://docs.ovh.com/fr/fr/web/domains/utilisation-dynhost/). diff --git a/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.md b/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.md index 60c33502..74bf8b9c 100644 --- a/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.md +++ b/pages/02.administer/55.providers/05.registrar/ovh/manualdns/manualdns.md @@ -47,7 +47,7 @@ ddclient will take care of telling OVH that the IP has changed. Then OVH will up You need to add in the configuration file: -* your login and password DynHost -* your domain name +- your login and password DynHost +- your domain name You should also check out [OVH's guide on DynHost](https://www.ovh.co.uk/g2024.hosting_dynhost). diff --git a/pages/02.administer/55.providers/10.isp/free/isp_free.fr.md b/pages/02.administer/55.providers/10.isp/free/isp_free.fr.md index b3f1b7b4..7b2bd721 100644 --- a/pages/02.administer/55.providers/10.isp/free/isp_free.fr.md +++ b/pages/02.administer/55.providers/10.isp/free/isp_free.fr.md @@ -11,21 +11,21 @@ routes: *Trouvez la liste d’autres fournisseurs d’accès à Internet **[ici](/isp)**.* -#### Accès à l’administration de la box (v5/v6) +## Accès à l’administration de la box (v5/v6) -##### Freebox ≤ v5 +### Freebox ≤ v5 Rendez-vous sur la [console d'administration du site de free](https://subscribe.free.fr/login/). -##### Freebox v6 (Revolution / Mini4k) +### Freebox v6 (Revolution / Mini4k) Allez à l’adresse : [mafreebox.freebox.fr](http://mafreebox.freebox.fr) puis authentifiez-vous. -#### Ouverture des ports +## Ouverture des ports [Liste des ports à ouvrir](/isp_box_config). -##### Freebox ≤ v5 +### Freebox ≤ v5 Cela se passe dans la section *Ma Freebox / Configurer mon routeur*. Il faut : @@ -34,11 +34,11 @@ Cela se passe dans la section *Ma Freebox / Configurer mon routeur*. Il faut : La présence conjointe de ces deux règles permettent d'accéder à votre serveur de l'extérieur comme de l'intérieur de votre réseau local. -##### Freebox v6 +### Freebox v6 [Tutoriel d’ouverture des ports sur Freebox](http://www.astuces-pratiques.fr/informatique/ouvrir-un-port-sur-la-freebox-revolution) -#### Déblocage de l’envoi de courriel +## Déblocage de l’envoi de courriel Pour pouvoir envoyer des mails, le déblocage se fait dans la [partie client](https://subscribe.free.fr/login/). @@ -46,7 +46,7 @@ Depuis le menu Ma freebox allez sur « Blocage SMTP sortant ». Pour pouvoir envoyer des mails, passez le blocage en « inactif ». -#### Fonction NAS de la Freebox +## Fonction NAS de la Freebox Il faut installer le paquet `cifs-utils` @@ -66,7 +66,7 @@ On monte le répertoire NAS par défaut avec les droits de lecture / écriture p sudo mount -t cifs //mafreebox.freebox.fr/Disque\ dur/ /home/monlogin/freebox -o guest,iocharset=utf8,file_mode=0777,dir_mode=0777 ``` -##### Automatiser le montage +### Automatiser le montage Une ligne à ajouter à la fin du `/etc/fstab` : diff --git a/pages/02.administer/55.providers/10.isp/isp.md b/pages/02.administer/55.providers/10.isp/isp.md index 776b12bf..5bd24c24 100644 --- a/pages/02.administer/55.providers/10.isp/isp.md +++ b/pages/02.administer/55.providers/10.isp/isp.md @@ -133,7 +133,7 @@ Tous les fournisseurs d’accès à Internet [membres de la Fédération French | **[UPnP](https://fr.wikipedia.org/wiki/Universal_Plug_and_Play)** | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | **[Port 25 ouvrable](/email)**
(fermé par défaut) | ✔ | ✔ | ✔ | ✘ | ✔ | ✔ | | **[Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning)** | ✔ | ✔ | ✔/✘ | ✔ (depuis la Livebox 4) | ✔ | ✔ | -| **[Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)
personnalisable ** | ✔ | ✔ (sauf IPv6, pas de support, et buggué sur certaines plages d'adresses ipv4) | … | ✘ (XXX.pro.dns-orange.fr disponible sur les abonnements orange pro) | ✘ | ✘ | +| **[Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)
personnalisable** | ✔ | ✔ (sauf IPv6, pas de support, et buggué sur certaines plages d'adresses ipv4) | … | ✘ (XXX.pro.dns-orange.fr disponible sur les abonnements orange pro) | ✘ | ✘ | | **[IP fixe](/dns_dynamicip)** | ✔ | ✔ | ✔/✘ | ✘ (en option depuis la Livebox 3 et sur les abonnements orange pro) | ✔ | ✔ | | **[IPv6](https://fr.wikipedia.org/wiki/IPv6)** | ✔ | ✔ | ✔ | ✔ | … | … | | **[Non listé sur le DUL](https://en.wikipedia.org/wiki/Dialup_Users_List)** | … | ✘ | … | … | … | … | diff --git a/pages/02.administer/55.providers/10.isp/orange/isp_orange.fr.md b/pages/02.administer/55.providers/10.isp/orange/isp_orange.fr.md index 1efb71c0..d6275a2f 100644 --- a/pages/02.administer/55.providers/10.isp/orange/isp_orange.fr.md +++ b/pages/02.administer/55.providers/10.isp/orange/isp_orange.fr.md @@ -11,7 +11,7 @@ routes: *Trouvez la liste d’autres fournisseurs d’accès à Internet **[ici](/isp)**.* -#### Le courrier électronique +## Le courrier électronique La box d’Orange bloque le port 25 pour limiter l’envoi de spam. @@ -38,7 +38,7 @@ redémarrez Postfix : sudo service postfix restart ``` -##### Problèmes +### Problèmes Si vous avez une erreur "Authentification requise", la solution est la suivante : **[source](http://viruslocker.free.fr/?page_id=1749)**. diff --git a/pages/02.administer/55.providers/10.isp/sfr/isp_sfr.fr.md b/pages/02.administer/55.providers/10.isp/sfr/isp_sfr.fr.md index 1822c38f..14ea8ea5 100644 --- a/pages/02.administer/55.providers/10.isp/sfr/isp_sfr.fr.md +++ b/pages/02.administer/55.providers/10.isp/sfr/isp_sfr.fr.md @@ -11,14 +11,14 @@ routes: *Trouvez la liste d’autres fournisseurs d’accès à Internet **[ici](/isp)**.* -#### Accès à l’administration de la box +## Accès à l’administration de la box -* Allez à cette adresse : -* Authentifiez-vous, soit en appuyant sur le bouton de la box pendant 5 secondes soit avec les identifiants d’administration. +- Allez à cette adresse : +- Authentifiez-vous, soit en appuyant sur le bouton de la box pendant 5 secondes soit avec les identifiants d’administration. ![](image://sfr-authentification.png?resize=900) -#### Courrier électronique +## Courrier électronique Pour pouvoir envoyer des mails, il faut désactiver le filtrage. diff --git a/pages/02.administer/55.providers/15.vpn/vpn.md b/pages/02.administer/55.providers/15.vpn/vpn.md index 7107a5fb..e453896c 100644 --- a/pages/02.administer/55.providers/15.vpn/vpn.md +++ b/pages/02.administer/55.providers/15.vpn/vpn.md @@ -21,7 +21,7 @@ Below, you can find a list of providers compatible for self-hosting and especial !!! - port forwarding or opened features !!! - net neutrality: no traffic analysis, no user data resale, no alteration of traffic (without legal obligations)... ------------------- +--- ## English speaking-site diff --git a/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md b/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md index 1f954752..02faf257 100644 --- a/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md +++ b/pages/02.administer/60.extend/05.install_unpackaged_app/install_unpackaged_app.md @@ -10,11 +10,11 @@ routes: ## PHP or HTML/JS apps -If your app is a PHP or HTML/JS app, you probably should use the `Custom Webapp`, also know as `my_webapp`, in order to configure nginx, php, mysql, yunohost permission and backup for you. +If your app is a PHP or HTML/JS app, you probably should use the `Custom Webapp`, also know as `my_webapp`, in order to configure nginx, php, mysql, YunoHost permission and backup for you. ## Other technologies -If you use some other technology, you should install it like on a classical debian. +If you use some other technology, you should install it like on a classical Debian. To expose the app on the web through nginx and be able to manage access permissions to the webapp, you could use the [`redirect` app](https://github.com/YunoHost-Apps/redirect_ynh/) to create a nginx reverse proxy on your local ip/port running the service. diff --git a/pages/02.administer/60.extend/15.theming/theming.md b/pages/02.administer/60.extend/15.theming/theming.md index b042390e..72172c95 100644 --- a/pages/02.administer/60.extend/15.theming/theming.md +++ b/pages/02.administer/60.extend/15.theming/theming.md @@ -42,7 +42,7 @@ You may add themes created by other people by downloading and extracting the cor ! **Beware** that adding third-party themes from random strangers on the internet **is a security risk**. It is equivalent to running someone's else code on your machine, which can be used for malicious purpose such as stealing credentials! -There are a handful of themes listed [on Github](https://github.com/yunohost-themes). +There are a handful of themes listed [on GitHub](https://github.com/yunohost-themes). ## Creating your own theme diff --git a/pages/03.user_guide/05.emailclients/email_configure_client.de.md b/pages/03.user_guide/05.emailclients/email_configure_client.de.md index 08d04fa4..f1eb5258 100644 --- a/pages/03.user_guide/05.emailclients/email_configure_client.de.md +++ b/pages/03.user_guide/05.emailclients/email_configure_client.de.md @@ -32,7 +32,7 @@ Um ein neues Konto in Thunderbird manuell zu konfigurieren, fügen Sie die Konto ![](image://thunderbird_config_1.png?resize=900) ![](image://thunderbird_config_2.png?resize=900) -* [Alias-Mails verwalten](https://support.mozilla.org/de/kb/configuring-email-aliases) +- [Alias-Mails verwalten](https://support.mozilla.org/de/kb/configuring-email-aliases) [/ui-tab] [ui-tab title="K-9 Mail"] @@ -53,7 +53,7 @@ Führen Sie die folgenden Schritte aus. (Wie bei Thunderbird müssen Sie möglic Beim ersten Mal können Sie einfach "Konto hinzufügen" wählen. Wenn Sie bereits ein Konto eingerichtet haben, tippen Sie auf das Hamburger-Menü, dann auf das Zahnrad, wählen Sie Mail, Konten und drücken Sie das '+'-Symbol. -Dann wählen Sie IMAP. Füllen Sie die Felder aus und drücken Sie auf Weiter. Jetzt sucht Dekko nach der Konfiguration. Überprüfen Sie, ob alle Felder korrekt ausgefüllt sind. Vergewissern Sie sich, dass Sie Ihren yunohost-Benutzernamen und NICHT Ihre Mailadresse eingeben und wählen Sie "Nicht vertrauenswürdige Zertifikate zulassen". Tun Sie dies für IMAP und SMTP und drücken Sie auf Weiter. Dekko wird nun das Konto synchronisieren, danach sind Sie fertig. Herzlichen Glückwunsch! +Dann wählen Sie IMAP. Füllen Sie die Felder aus und drücken Sie auf Weiter. Jetzt sucht Dekko nach der Konfiguration. Überprüfen Sie, ob alle Felder korrekt ausgefüllt sind. Vergewissern Sie sich, dass Sie Ihren YunoHost-Benutzernamen und NICHT Ihre Mailadresse eingeben und wählen Sie "Nicht vertrauenswürdige Zertifikate zulassen". Tun Sie dies für IMAP und SMTP und drücken Sie auf Weiter. Dekko wird nun das Konto synchronisieren, danach sind Sie fertig. Herzlichen Glückwunsch! ![](image://dekko_config_1.png?resize=280&classes=inline) ![](image://dekko_config_2.png?resize=280&classes=inline) diff --git a/pages/03.user_guide/05.emailclients/email_configure_client.es.md b/pages/03.user_guide/05.emailclients/email_configure_client.es.md index 8f8a56c8..48644c0b 100644 --- a/pages/03.user_guide/05.emailclients/email_configure_client.es.md +++ b/pages/03.user_guide/05.emailclients/email_configure_client.es.md @@ -26,7 +26,7 @@ Para configurar manualmente un nuevo cuenta en Thunderbird, añadir las informac ![](image://thunderbird_config_1.png?resize=900) ![](image://thunderbird_config_2.png?resize=900) -* [Gestionar un alias para una dirección de correo electrónico](https://support.mozilla.org/es/kb/configurar-un-alias-para-una-direccin-de-correo-el) +- [Gestionar un alias para una dirección de correo electrónico](https://support.mozilla.org/es/kb/configurar-un-alias-para-una-direccin-de-correo-el) ### ![](image://k9mail.png?resize=50&classes=inline) Configurar K-9 Mail (en Android) diff --git a/pages/03.user_guide/05.emailclients/email_configure_client.fr.md b/pages/03.user_guide/05.emailclients/email_configure_client.fr.md index 0c396ab4..b240b3b1 100644 --- a/pages/03.user_guide/05.emailclients/email_configure_client.fr.md +++ b/pages/03.user_guide/05.emailclients/email_configure_client.fr.md @@ -32,7 +32,7 @@ Pour configurer manuellement un nouveau compte dans Thunderbird commencez par re ![](image://thunderbird_config_1.png?resize=900) ![](image://thunderbird_config_2.png?resize=900) -* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) +- [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) [/ui-tab] diff --git a/pages/03.user_guide/05.emailclients/email_configure_client.it.md b/pages/03.user_guide/05.emailclients/email_configure_client.it.md index 5f37680c..5595cbcc 100644 --- a/pages/03.user_guide/05.emailclients/email_configure_client.it.md +++ b/pages/03.user_guide/05.emailclients/email_configure_client.it.md @@ -32,7 +32,7 @@ Per configurare manualmente un nuovo account in Thunderbird, iniziate ad inserir ![](image://thunderbird_config_1.png?resize=900) ![](image://thunderbird_config_2.png?resize=900) -* [Gestione alias email](https://support.mozilla.org/en-US/kb/configuring-email-aliases) +- [Gestione alias email](https://support.mozilla.org/en-US/kb/configuring-email-aliases) [/ui-tab] [ui-tab title="K-9 Mail"] diff --git a/pages/03.user_guide/05.emailclients/email_configure_client.md b/pages/03.user_guide/05.emailclients/email_configure_client.md index b9095a09..3e6881da 100644 --- a/pages/03.user_guide/05.emailclients/email_configure_client.md +++ b/pages/03.user_guide/05.emailclients/email_configure_client.md @@ -32,7 +32,7 @@ To manually configure a new account in Thunderbird, add the account information, ![](image://thunderbird_config_1.png?resize=900) ![](image://thunderbird_config_2.png?resize=900) -* [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) +- [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases) [/ui-tab] [ui-tab title="K-9 Mail"] @@ -53,7 +53,7 @@ Follow the following steps. (As for Thunderbird, you might need to accept certif The first time you can simply choose "Add account". If you already have an account configured, tap the hamburger menu then tap the gear, choose Mail, Accounts and press the '+'-symbol. -Then you choose IMAP. Fill in the fields and press Next. Now Dekko will look for the configuration. Check that all fields are correct. Make sure you have your yunohost username, NOT your email address and choose "Allow untrusted certificates". Do this for IMAP and SMTP and press Next. Dekko will now synchronise the account after which you are done. Congratz! +Then you choose IMAP. Fill in the fields and press Next. Now Dekko will look for the configuration. Check that all fields are correct. Make sure you have your YunoHost username, NOT your email address and choose "Allow untrusted certificates". Do this for IMAP and SMTP and press Next. Dekko will now synchronise the account after which you are done. Congratz! ![](image://dekko_config_1.png?resize=280&classes=inline) ![](image://dekko_config_2.png?resize=280&classes=inline) diff --git a/pages/03.user_guide/15.xmpp/xmpp.es.md b/pages/03.user_guide/15.xmpp/xmpp.es.md index fcd7f01a..434e67fe 100644 --- a/pages/03.user_guide/15.xmpp/xmpp.es.md +++ b/pages/03.user_guide/15.xmpp/xmpp.es.md @@ -50,6 +50,7 @@ Aquí tienes una lista más exhaustiva de clientes XMPP (en) : Plugins` - Activar el cifrado en una conversación con un contacto que también tiene OMEMO activado. diff --git a/pages/05.community/10.chat_rooms/chat_rooms.es.md b/pages/05.community/10.chat_rooms/chat_rooms.es.md index ff0f697a..01509c6a 100644 --- a/pages/05.community/10.chat_rooms/chat_rooms.es.md +++ b/pages/05.community/10.chat_rooms/chat_rooms.es.md @@ -19,34 +19,34 @@ Puede unirse a una sala de chat utilizando : Existen salas publicas de chat de [soporte](/help) y ayuda para YunoHost: -- IRC: **#yunohost** on libera.chat ; -- Matrix: **[#yunohost:matrix.org](https://matrix.to/#/#yunohost:matrix.org)** ; -- XMPP: **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)** +- IRC: **`#yunohost`** on libera.chat ; +- Matrix: **[`#yunohost:matrix.org`](https://matrix.to/#/#yunohost:matrix.org)** ; +- XMPP: **[`support@conference.yunohost.org`](xmpp:support@conference.yunohost.org?join)** #### sala de chat para desarrolladores Salas de chat para el desarollo de YunoHost: -- IRC: **#yunohost-dev** on libera.chat ; -- Matrix: **#[yunohost-dev:matrix.org](https://matrix.to/#/#yunohost-dev:libera.chat)** ; -- XMPP: **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)** +- IRC: **`#yunohost-dev`** on libera.chat ; +- Matrix: **#[`yunohost-dev:matrix.org`](https://matrix.to/#/#yunohost-dev:libera.chat)** ; +- XMPP: **[`dev@conference.yunohost.org`](xmpp:dev@conference.yunohost.org?join)** Actualmente, la sala principal de chat para contribuciones en YunoHost -Para mas ayuda, vea la sala de chat **#yunohost** encima. +Para mas ayuda, vea la sala de chat **`#yunohost`** encima. #### Sala de chat para las integración de aplicaciones Estos permite la ayuda mutua para los integradores de aplicaciones y también para conversar de evoluciones et de herramientas de integración continua. -- IRC: **#yunohost-apps** en libera.chat -- Matrix: **[#yunohost-apps:matrix.org](https://matrix.to/#/#yunohost-apps:matrix.org)** -- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)** +- IRC: **`#yunohost-apps`** en libera.chat +- Matrix: **[`#yunohost-apps:matrix.org`](https://matrix.to/#/#yunohost-apps:matrix.org)** +- XMPP: **[`apps@conference.yunohost.org`](xmpp:apps@conference.yunohost.org?join)** #### Sala de chat de Documentación Lugar donde la comunidad conversa sincroniza y mantiene actualisado la documentación en los aspectos varios como (backend, frontend, apps, proyecto, comunidad...) Puede tambien compartir sus materiales sobre YunoHost (videos, presentaciones, etc.). -- IRC: **#yunohost-doc** on libera.chat -- Matrix: **[#yunohost-doc:matrix.org](https://matrix.to/#/#yunohost-doc:matrix.org)** -- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)** +- IRC: **`#yunohost-doc`** on libera.chat +- Matrix: **[`#yunohost-doc:matrix.org`](https://matrix.to/#/#yunohost-doc:matrix.org)** +- XMPP: **[`doc@conference.yunohost.org`](xmpp:doc@conference.yunohost.org?join)** diff --git a/pages/05.community/10.chat_rooms/chat_rooms.fr.md b/pages/05.community/10.chat_rooms/chat_rooms.fr.md index 573d4607..d292c7c0 100644 --- a/pages/05.community/10.chat_rooms/chat_rooms.fr.md +++ b/pages/05.community/10.chat_rooms/chat_rooms.fr.md @@ -19,17 +19,17 @@ Vous pouvez rejoindre ces salons avec : Le salon d’[entraide](/help) est là pour permettre aux utilisateurs de YunoHost de s'aider mutuellement. -- IRC : **#yunohost** sur libera.chat (voir KiwiIRC ci-dessus) -- Matrix : **[#yunohost:matrix.org](https://matrix.to/#/#yunohost:matrix.org)** -- XMPP : **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)** +- IRC : **`#yunohost`** sur libera.chat (voir KiwiIRC ci-dessus) +- Matrix : **[`#yunohost:matrix.org`](https://matrix.to/#/#yunohost:matrix.org)** +- XMPP : **[`support@conference.yunohost.org`](xmpp:support@conference.yunohost.org?join)** #### Développement Salon de développement du cœur de YunoHost : -- IRC : **#yunohost-dev** sur libera.chat -- Matrix : **[#yunohost-dev:matrix.org](https://matrix.to/#/#yunohost-dev:matrix.org)** -- XMPP : **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)** +- IRC : **`#yunohost-dev`** sur libera.chat +- Matrix : **[`#yunohost-dev:matrix.org`](https://matrix.to/#/#yunohost-dev:matrix.org)** +- XMPP : **[`dev@conference.yunohost.org`](xmpp:dev@conference.yunohost.org?join)** C'est le salon principal pour les contributions autour du projet. Pour chercher de l’aide, merci d'aller sur le salon d’entraide ci-dessus. @@ -39,15 +39,15 @@ Pour chercher de l’aide, merci d'aller sur le salon d’entraide ci-dessus. Salon de développement du packaging d’application. Il permet aux packageurs de s’entraider. Il sert également à discuter de l’évolution du packaging, des outils d’intégration continue sur les applications. -- IRC : **#yunohost-apps** sur libera.chat -- Matrix : **[#yunohost-apps:matrix.org](https://matrix.to/#/#yunohost-apps:matrix.org)** -- XMPP : **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)** +- IRC : **`#yunohost-apps`** sur libera.chat +- Matrix : **[`#yunohost-apps:matrix.org`](https://matrix.to/#/#yunohost-apps:matrix.org)** +- XMPP : **[`apps@conference.yunohost.org`](xmpp:apps@conference.yunohost.org?join)** #### Documentation Le salon de documentation du projet YunoHost. Il permet aux contributeurs d'échanger, pour synchroniser et maintenir une documentation à jour sur les différents aspects du projet : backend, frontend, apps, projet, communauté... Vous pouvez aussi y partager vos communications au public à propos de YunoHost (présentations, vidéos...) pour permettre leur référencement dans la documentation. -- IRC : **#yunohost-doc** sur libera.chat -- Matrix : **[#yunohost-doc:matrix.org](https://matrix.to/#/#yunohost-doc:matrix.org)** -- XMPP : **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)** +- IRC : **`#yunohost-doc`** sur libera.chat +- Matrix : **[`#yunohost-doc:matrix.org`](https://matrix.to/#/#yunohost-doc:matrix.org)** +- XMPP : **[`doc@conference.yunohost.org`](xmpp:doc@conference.yunohost.org?join)** diff --git a/pages/05.community/10.chat_rooms/chat_rooms.md b/pages/05.community/10.chat_rooms/chat_rooms.md index f28461f9..3799f0ad 100644 --- a/pages/05.community/10.chat_rooms/chat_rooms.md +++ b/pages/05.community/10.chat_rooms/chat_rooms.md @@ -21,29 +21,29 @@ You could join those chat rooms using: There is a [support](/help) chat room for YunoHost users mutual support and help. -- IRC: **#yunohost** on libera.chat -- Matrix: **[#yunohost:matrix.org](https://matrix.to/#/#yunohost:matrix.org)** -- XMPP: **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)** +- IRC: **`#yunohost`** on libera.chat +- Matrix: **[`#yunohost:matrix.org`](https://matrix.to/#/#yunohost:matrix.org)** +- XMPP: **[`support@conference.yunohost.org`](xmpp:support@conference.yunohost.org?join)** #### Development chat room YunoHost core development chat room: -- IRC: **#yunohost-dev** on libera.chat -- Matrix: **[#yunohost-dev:matrix.org](https://matrix.to/#/#yunohost-dev:matrix.org)** -- XMPP: **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)** +- IRC: **`#yunohost-dev`** on libera.chat +- Matrix: **[`#yunohost-dev:matrix.org`](https://matrix.to/#/#yunohost-dev:matrix.org)** +- XMPP: **[`dev@conference.yunohost.org`](xmpp:dev@conference.yunohost.org?join)** Currently, the main chat room for contributions on YunoHost project. -For help, please see **#yunohost** chat room above. +For help, please see **`#yunohost`** chat room above. #### Applications chat room Application packaging development chat room. It allow packagers to help each other. It also allow to discuss packaging evolution, continuous integration tools: -- IRC: **#yunohost-apps** on libera.chat -- Matrix: **[#yunohost-apps:matrix.org](https://matrix.to/#/#yunohost-apps:matrix.org)** -- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)** +- IRC: **`#yunohost-apps`** on libera.chat +- Matrix: **[`#yunohost-apps:matrix.org`](https://matrix.to/#/#yunohost-apps:matrix.org)** +- XMPP: **[`apps@conference.yunohost.org`](xmpp:apps@conference.yunohost.org?join)** #### Documentation chat room @@ -51,6 +51,6 @@ YunoHost project documentation chat room. It allow people to discuss, synchroniz an up-to-date documentation on the differents aspects of the project (backend, frontend, apps, project, community...). You may also share here your public communications about YunoHost (videos, presentations, etc.), to allow proper referencing. -- IRC: **#yunohost-doc** on libera.chat -- Matrix: **[#yunohost-doc:matrix.org](https://matrix.to/#/#yunohost-doc:matrix.org)** -- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)** +- IRC: **`#yunohost-doc`** on libera.chat +- Matrix: **[`#yunohost-doc:matrix.org`](https://matrix.to/#/#yunohost-doc:matrix.org)** +- XMPP: **[`doc@conference.yunohost.org`](xmpp:doc@conference.yunohost.org?join)** diff --git a/pages/05.community/20.faq/faq.it.md b/pages/05.community/20.faq/faq.it.md index 0953c8c8..7dc18665 100644 --- a/pages/05.community/20.faq/faq.it.md +++ b/pages/05.community/20.faq/faq.it.md @@ -7,7 +7,7 @@ routes: default: '/faq' --- -#### Con quale licenza è rilasciato Yunohost? +#### Con quale licenza è rilasciato YunoHost? I pacchetti che si trovano in YunoHost sono rilasciati con licenza GNU AGPL v.3. diff --git a/pages/05.community/35.project_budget/project_budget.fr.md b/pages/05.community/35.project_budget/project_budget.fr.md index 15f008c9..f98ad7a0 100644 --- a/pages/05.community/35.project_budget/project_budget.fr.md +++ b/pages/05.community/35.project_budget/project_budget.fr.md @@ -11,32 +11,32 @@ routes: ## Revenus attendus -- Dons via Liberapay : 3000€ -- Subvention de NLNet : 20K€ +- Dons via Liberapay : 3000 € +- Subvention de NLNet : 20K € ## Dépenses prévues -- Developpement : 20K€ +- Developpement : 20K € - Location Serveur : ~500 € - - VPS Scaleway: 20.33-12: 243.96€/year - - VPS Digital O. (forum): 172.80€/year + - VPS Scaleway: 20.33-12: 243.96 €/year + - VPS Digital O. (forum): 172.80 €/year - Noms de domaine : ~150 € - - nohost.me : 11.99 €HT/ans - - ynh.fr : 6.99 €HT/ans (doit être confirmé avec frju ?) - - noho.st : ~35 €TTC/ans - - yunohost.org : 13.99 €HT/ans - - yunohost.com : 9.99 €HT/ans - - labriqueinter.net : 12.49 €Ht/ans - - internetcu.be : 17.99 €HT/ans + - `nohost.me` : 11.99 €HT/ans + - `ynh.fr` : 6.99 €HT/ans (doit être confirmé avec frju ?) + - `noho.st` : ~35 €TTC/ans + - `yunohost.org` : 13.99 €HT/ans + - `yunohost.com` : 9.99 €HT/ans + - `labriqueinter.net` : 12.49 €Ht/ans + - `internetcu.be` : 17.99 €HT/ans - Communication : ~400 € - - Stickers : 100€ - - Tracts : 100€ - - T-shirt : 200€ + - Stickers : 100 € + - Tracts : 100 € + - T-shirt : 200 € - Déplacements (ex. : aller aux conférences) : ~700 € - - AG FFDN 2020 : 225€ (en tout) - - Event colibris : 150€ - - FOSDEM ou autre conf : 300€ + - AG FFDN 2020 : 225 € (en tout) + - Event colibris : 150 € + - FOSDEM ou autre conf : 300 € - Compte bancaire fees : 7×12 € soit ~100 € -- Brique Camp : 500€ +- Brique Camp : 500 € --Balance 2020-2021-- : +650 € diff --git a/pages/05.community/35.project_budget/project_budget.md b/pages/05.community/35.project_budget/project_budget.md index 1c346c27..ea7e2213 100644 --- a/pages/05.community/35.project_budget/project_budget.md +++ b/pages/05.community/35.project_budget/project_budget.md @@ -21,13 +21,13 @@ routes: - VPS Scaleway: 20.33-12: 243.96€/year - VPS Digital O. (forum): 172.80€/year - Domain names: ~150€ - - nohost.me: 11.99€HT/year - - ynh.fr: 6.99€HT/year (to be confirmed with frju?) - - noho.st: ~35€ TTC/year - - YunoHost.org: 13.99€HT/year - - YunoHost.com: 9.99€HT/year - - labriqueinter.net: 12.49€HT/year - - internetcu.be: 17.99€HT/year + - `nohost.me`: 11.99€HT/year + - `ynh.fr`: 6.99€HT/year (to be confirmed with frju?) + - `noho.st`: ~35€ TTC/year + - `yunohost.org`: 13.99€HT/year + - `yunohost.com`: 9.99€HT/year + - `labriqueinter.net`: 12.49€HT/year + - `internetcu.be`: 17.99€HT/year - Communication: ~400€ - Travel (e.g. to go to conferences): ~700€ - AG FFDN 2020: 225€ (en tout) diff --git a/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.fr.md b/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.fr.md index 35326d31..631b3ff5 100644 --- a/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.fr.md +++ b/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.fr.md @@ -206,23 +206,23 @@ Comme tel : Ce qui affichera : -+ Liste 1 -+ Liste 2 -+ liste 3 - + Liste 3a - + Liste 3b - + Liste 3b1 - + Liste 3b2 - + Liste 3b3 - + Liste 1 - + Liste 2 - + liste 3 +- Liste 1 +- Liste 2 +- liste 3 + - Liste 3a + - Liste 3b + - Liste 3b1 + - Liste 3b2 + - Liste 3b3 + - Liste 1 + - Liste 2 + - liste 3 - Liste 4 -* Liste 5 +- Liste 5 -+ liste 6 +- liste 6 ## Les tableaux @@ -273,9 +273,9 @@ Minimum trois accents graves en ouverture et fermeture de bloc et deux accents g ## Liens utiles -+ La documentation du langage originel Markdown : [daringfireball.net/projects/markdown (en)](https://daringfireball.net/projects/markdown/) -+ Tutoriel Markdown sur [markdowntutorial.com](https://markdowntutorial.com) +- La documentation du langage originel Markdown : [daringfireball.net/projects/markdown (en)](https://daringfireball.net/projects/markdown/) +- Tutoriel Markdown sur [markdowntutorial.com](https://markdowntutorial.com) ## Aller plus loin -De manière plus générale, pour comprendre comment est formaté un texte il suffit juste d'inspecter le document source avec une application note. Ce n'est pas pour autant que le wiki de YunoHost pourra l'exploiter. Il existe bien d'autres possibilités d'utiliser la syntaxe markdown, n'hésitez pas à ajouter des fonctionnalités manquantes. Si vous avez observé des manques et/ou que vous avez des questions, contactez-nous sur [le forum](https://forum.yunohost.org) ou par message direct sur le salon IRC : **#yunohost** sur [libera.chat](https://libera.chat). +De manière plus générale, pour comprendre comment est formaté un texte il suffit juste d'inspecter le document source avec une application note. Ce n'est pas pour autant que le wiki de YunoHost pourra l'exploiter. Il existe bien d'autres possibilités d'utiliser la syntaxe markdown, n'hésitez pas à ajouter des fonctionnalités manquantes. Si vous avez observé des manques et/ou que vous avez des questions, contactez-nous sur [le forum](https://forum.yunohost.org) ou par message direct sur le salon IRC : **#YunoHost** sur [libera.chat](https://libera.chat). diff --git a/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.md b/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.md index a16b546a..af7e87a7 100644 --- a/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.md +++ b/pages/06.contribute/05.write_documentation/02.markdown_guide/doc_markdown_guide.md @@ -206,23 +206,23 @@ As such: This will read: -+ List 1 -+ List 2 -+ list 3 - + List 3a - + List 3b - + List 3b1 - + List 3b2 - + List 3b3 - + List 1 - + List 2 - + list 3 +- List 1 +- List 2 +- list 3 + - List 3a + - List 3b + - List 3b1 + - List 3b2 + - List 3b3 + - List 1 + - List 2 + - list 3 - List 4 -* List 5 +- List 5 -+ list 6 +- list 6 ## Tables @@ -273,9 +273,9 @@ At least three low pitched accents at the opening and closing of the block and t ## Useful links -+ The documentation of the original Markdown language: [daringfireball.net/projects/markdown](https://daringfireball.net/projects/markdown/) -+ Markdown Tutorial on [markdowntutorial.com](https://markdowntutorial.com) +- The documentation of the original Markdown language: [daringfireball.net/projects/markdown](https://daringfireball.net/projects/markdown/) +- Markdown Tutorial on [markdowntutorial.com](https://markdowntutorial.com) ## Going further -In a more general way, to understand how a text is formatted just inspect the source document with a note application. This does not mean that the YunoHost wiki will be able to exploit it. There are many other possibilities to use markdown syntax, feel free to add missing features. If you've noticed some missing features and/or have questions, please contact us on [the forum](https://forum.yunohost.org) or by direct message on the IRC room: **#yunohost** on [libera.chat](https://libera.chat). +In a more general way, to understand how a text is formatted just inspect the source document with a note application. This does not mean that the YunoHost wiki will be able to exploit it. There are many other possibilities to use markdown syntax, feel free to add missing features. If you've noticed some missing features and/or have questions, please contact us on [the forum](https://forum.yunohost.org) or by direct message on the IRC room: **#YunoHost** on [libera.chat](https://libera.chat). diff --git a/pages/06.contribute/05.write_documentation/03.git/doc_use_git.fr.md b/pages/06.contribute/05.write_documentation/03.git/doc_use_git.fr.md index ce98554a..d8b652b8 100644 --- a/pages/06.contribute/05.write_documentation/03.git/doc_use_git.fr.md +++ b/pages/06.contribute/05.write_documentation/03.git/doc_use_git.fr.md @@ -7,9 +7,9 @@ routes: default: '/doc_use_git' --- -Il est bien sûr possible de contribuer directement sur la documentation de YunoHost, mais ce n’est pas la manière la plus pratique de le faire tant pour le·la contributeur·rice que pour la personne qui va injecter votre contribution dans la documentation. Voici un tutoriel pour comprendre et créer une contribution à la documentation de YunoHost en utilisant l’outil [Git (en)](https://git-scm.com/) et [github.com](http://github.com/) qui est le service de forge Git qui héberge et stocke le code source de YunoHost ainsi que sa documentation. +Il est bien sûr possible de contribuer directement sur la documentation de YunoHost, mais ce n’est pas la manière la plus pratique de le faire tant pour le·la contributeur·rice que pour la personne qui va injecter votre contribution dans la documentation. Voici un tutoriel pour comprendre et créer une contribution à la documentation de YunoHost en utilisant l’outil [Git (en)](https://git-scm.com/) et [GitHub.com](http://github.com/) qui est le service de forge Git qui héberge et stocke le code source de YunoHost ainsi que sa documentation. -## Création d’un compte sur github.com +## Création d’un compte sur GitHub.com Pour pouvoir envoyer vos contributions via GitHub, il est nécessaire d’avoir un compte sur GitHub. Pour créer le compte vous aurez besoin d’une adresse e-mail valide à laquelle vous avez accès. GitHub est un outil puissant qui propose de nombreuses fonctionnalités, l’interface peut être un peu effrayante au début. Vous n’êtes pas obligé·e de donner vos noms et prénoms, vous pouvez utiliser un pseudonyme (lors de l’inscription `Username`). @@ -44,7 +44,7 @@ Lorsque vous avez déjà fait une PR (Pull Request), les modifications de votre ## Faire remonter des erreurs et des souhaits par des issues -YunoHost dispose d’un dépôt Git spécifique pour le recueil des issues : [github.com/YunoHost/issues](https://github.com/YunoHost/issues) +YunoHost dispose d’un dépôt Git spécifique pour le recueil des issues : [GitHub.com/YunoHost/issues](https://github.com/YunoHost/issues) Une issue aussi appelé ticket, est un problème identifié ou alors un souhait de développement ; dans le cas présent pour la documentation, mais c’est valable pour tout dépôt logiciel. Dans le cadre de la documentation de YunoHost il sera surtout proposé des issues pour le développement de la documentation, les problèmes identifiés étant facilement corrigeables. ## Aller plus loin avec Git et travailler sur son poste de travail diff --git a/pages/06.contribute/05.write_documentation/03.git/doc_use_git.md b/pages/06.contribute/05.write_documentation/03.git/doc_use_git.md index 76aa62a6..4828b838 100644 --- a/pages/06.contribute/05.write_documentation/03.git/doc_use_git.md +++ b/pages/06.contribute/05.write_documentation/03.git/doc_use_git.md @@ -7,9 +7,9 @@ routes: default: '/doc_use_git' --- -It is of course possible to contribute directly to the YunoHost documentation, but this is not the most convenient way to do so for both the contributor and the person who will inject your contribution into the documentation. Here is a tutorial to understand and create a contribution to the YunoHost documentation using [Git](https://git-scm.com/) and [github.com](http://github.com/) which is the Git forge service that hosts and stores the YunoHost source code and documentation. +It is of course possible to contribute directly to the YunoHost documentation, but this is not the most convenient way to do so for both the contributor and the person who will inject your contribution into the documentation. Here is a tutorial to understand and create a contribution to the YunoHost documentation using [Git](https://git-scm.com/) and [GitHub.com](http://github.com/) which is the Git forge service that hosts and stores the YunoHost source code and documentation. -## Create an account on github.com +## Create an account on GitHub.com To be able to send your contributions via GitHub, you need to have an account on GitHub, to create the account you will need a valid email address that you have access to. GitHub is a powerful tool with many features, the interface can be a little scary at first. You don't have to give your first and last names, you can use a nickname (when you register `Username`). @@ -24,7 +24,7 @@ In the title of the new repository, you will see where the repository comes from ![Screenshots title and subtitle of the repository](image://github_fork_title.png) > **Point of vigilance !** -> If you forge the repository of another contributor than yunohost, you'll get the same files. Except that when you send your changes, they will be sent to the contributor and not to the yunohost repository. The advantage is that it allows you to develop another branch created by the contributor and work with another person on an improvement before submitting it to the main repository. +> If you forge the repository of another contributor than YunoHost, you'll get the same files. Except that when you send your changes, they will be sent to the contributor and not to the YunoHost repository. The advantage is that it allows you to develop another branch created by the contributor and work with another person on an improvement before submitting it to the main repository. > It is not possible to have a fork from a contributor's repository and the original repository fork at the same time in your own account. ## Modify and add your contribution @@ -42,7 +42,7 @@ When you've already create a Pull Request (PR), changes to your development bran ## Bringing up mistakes and wishes through issues -YunoHost has a specific Git repository to collect issues: [github.com/YunoHost/issues](https://github.com/YunoHost/issues) +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 your workstation diff --git a/pages/06.contribute/10.packaging_apps/10.manifest/docs.md b/pages/06.contribute/10.packaging_apps/10.manifest/docs.md index 254c3995..c9563b87 100644 --- a/pages/06.contribute/10.packaging_apps/10.manifest/docs.md +++ b/pages/06.contribute/10.packaging_apps/10.manifest/docs.md @@ -33,7 +33,7 @@ maintainers = ["alexAubin"] - `name` (`str`) is the display name of the app, shown for example in the webadmin UI or user portal. It is limited to 22 chars (though not sure why this number?). - `description` (`dict` of `lang code`->`str`) contains *short*, *concise* descriptions of the app in different languages (at least `en`). It is limited to 150 chars. It will be displayed on the app catalog and should allow people to understand what this app is about at a glance. A more extensive description of the app can be provided in `doc/DESCRIPTION.md`. - `version` (`str`) is composed of the *upstream* version of the app shipped, and an `~ynhX` suffix. Changing this version is what effectively triggers an available upgrade for YunoHost instances which installed this package (hence no upgrade will be displayed as available if you forget to change it). The point of the `~ynhX` suffix is to have a way to increment the version when commiting changes unrelated to the upstream but still trigger an upgrade. -- `maintainers` (`list` or `str`) may allow to declare which person should be the referring person for this package (though packages are often maintained collectively and not really used in practice). This should contain a list of easily identifiable persons (eg your Github or Matrix username) +- `maintainers` (`list` or `str`) may allow to declare which person should be the referring person for this package (though packages are often maintained collectively and not really used in practice). This should contain a list of easily identifiable persons (eg your GitHub or Matrix username) ## Upstream section @@ -88,7 +88,7 @@ ram.runtime = "1M" This section is completely optional and, for most apps, doesn't exist at all. -Some applications have limitations, they might be due to non-free dependencies, arbitrary limitations, etc. Yunohost provides UI in the catalog to show such antifeatures. +Some applications have limitations, they might be due to non-free dependencies, arbitrary limitations, etc. YunoHost provides UI in the catalog to show such antifeatures. The declaration of antifeatures is a 3-steps process: @@ -143,7 +143,7 @@ This section contains questions that should be asked to the admin prior to start - `help.en` is an optional additional message to provide further info about this question - `type` is the type of question, in this case `string` - in this example, we don't want a free user input but choosing between `cat`, `dog` or `both` (with proper human-readable versions of these choices) - - this will later automatically create a yunohost app setting named `prefered_pet` + - this will later automatically create a YunoHost app setting named `prefered_pet` - .. and in the bash install script, the bash variable will automatically be available `$prefered_pet` with the chosen value ### Regarding install question types diff --git a/pages/06.contribute/10.packaging_apps/30.doc/doc.md b/pages/06.contribute/10.packaging_apps/30.doc/doc.md index b6b8c332..bc4f5d35 100644 --- a/pages/06.contribute/10.packaging_apps/30.doc/doc.md +++ b/pages/06.contribute/10.packaging_apps/30.doc/doc.md @@ -20,7 +20,7 @@ This description and screenshot will be shown when the admin open the catalog pa You can also add translated versions of the `.md` file in, for example, `doc/DESCRIPTION_fr.md`, `_es.md`, `_it.md`, etc. -If your app repository is part of the YunoHost-Apps org, the provided description will be used to auto-regenerate the README.md of your github repo via `yunohost-bot`. +If your app repository is part of the YunoHost-Apps org, the provided description will be used to auto-regenerate the README.md of your GitHub repo via `yunohost-bot`. ## Specific notes for admins : `doc/ADMIN.md`, `doc/.md` diff --git a/pages/06.contribute/10.packaging_apps/60.advanced/50.hooks/packaging_apps_hooks.md b/pages/06.contribute/10.packaging_apps/60.advanced/50.hooks/packaging_apps_hooks.md index c9d212d8..814dcc9b 100644 --- a/pages/06.contribute/10.packaging_apps/60.advanced/50.hooks/packaging_apps_hooks.md +++ b/pages/06.contribute/10.packaging_apps/60.advanced/50.hooks/packaging_apps_hooks.md @@ -357,7 +357,7 @@ This hook is run at the end of the command `yunohost app upgrade` or equivalent - YNH_ARCH: The arch as returned by `dpkg --print-architecture` - YNH_APP_UPGRADE_TYPE: The type of upgrade (UPGRADE_PACKAGE, UPGRADE_APP, UPGRADE_FULL) - YNH_APP_MANIFEST_VERSION: The version number -- YNH_APP_CURRENT_VERSION: The version number of the app (in the yunohost format) +- YNH_APP_CURRENT_VERSION: The version number of the app (in the YunoHost format) - NO_BACKUP_UPGRADE: 1 if we don't want to backup else 0 ##### No positionnal arguments diff --git a/pages/06.contribute/10.packaging_apps/60.advanced/60.advanced_packagers/advanced_packagers.md b/pages/06.contribute/10.packaging_apps/60.advanced/60.advanced_packagers/advanced_packagers.md index 325a502e..c8b5def6 100644 --- a/pages/06.contribute/10.packaging_apps/60.advanced/60.advanced_packagers/advanced_packagers.md +++ b/pages/06.contribute/10.packaging_apps/60.advanced/60.advanced_packagers/advanced_packagers.md @@ -8,6 +8,7 @@ routes: --- Here comes the time: + - you masterise [apps packaging](/packaging_apps), [package_check](https://github.com/YunoHost/package_check), [example_ynh](https://github.com/YunoHost/example_ynh) and [experimental helpers](https://github.com/YunoHost-Apps/Experimental_helpers) - you have integrated the [YunoHost Apps Group](https://yunohost.org/#/project_organization) - you know what means `¯\_(ツ)_/¯` @@ -16,6 +17,7 @@ Here comes the time: Here are few ideas that could help you to improve YunoHost apps packaging. Usually, there are things that slow you down: + - Installing your freshly done package because of dependencies installation or npm/rust/elixir/composer builds - Waiting a package_check to see the level of your package - etc... @@ -23,19 +25,22 @@ Usually, there are things that slow you down: The idea is to use YunoHost stuffs to help you improve this lost time. ## Building your infrastructure + First idea is to build several VMs, LXCs or VirtualBoxs with YunoHost to let you parallelize actions, like having the first one installing an app, the second installing another app, the third one debugging an app upgrade, etc... After first installation of those VMs/LXCs, each one has to be reacheable with its domain name, like for example: + - ynh1.mydomain.org - ynh2.mydomain.org - ynh3.mydomain.org -For that you will need a public IP for each one or reverse proxy... +For that you will need a public IP for each one or reverse proxy... If your are lucky enough to have IPV6 and a /64 IPV6 scope, it won't be a problem to assign a public IPV6 to each YunoHost. Another way the DNS stuff is to simply use an hosts file. In addition, it's helpfull to have several domains names for each YunoHost, for example: + - ynh1.mydomain.org - test11.mydomain.org - test12.mydomain.org @@ -49,7 +54,7 @@ In addition, it's helpfull to have several domains names for each YunoHost, for - test32.mydomain.org - test33.mydomain.org -With that you will be able to install two apps on the same YunoHost first one at https://test11.mydomain.org and a second app at https://test12.mydomain.org (let say the first app is nextcloud_ynh the second one is collabora_ynh or onlyoffice_ynh) +With that you will be able to install two apps on the same YunoHost first one at and a second app at (let say the first app is nextcloud_ynh the second one is collabora_ynh or onlyoffice_ynh) When your infrastructure is up and ready, you will have to do snapshots of each VMs/LXCs. Doing that, you will be able to revert back to an happy and healthy YunoHost after doing install/backup/restore/upgrade of and app... @@ -57,7 +62,7 @@ Don't forget to regularly upgrade your YunoHosts VMs/LXCs to the last release do Example of a script to upgrade a master VirtualBox VM -``` +```bash #!/bin/bash # printers @@ -67,7 +72,7 @@ white="\e[97m" blue="\e[34m" echo_info() { - echo -e "[${bold}${blue}INFO${normal}] ${bold}${white}$1${normal}" + echo -e "[${bold}${blue}INFO${normal}] ${bold}${white}$1${normal}" } echo_info "### Update host" @@ -94,7 +99,7 @@ echo_info "### Run 'VBoxManage modifyhd --compact file.vdi' to reduce the size o Example of a script to customize a cloned VM -``` +```bash #!/bin/bash master_domain=domain1.fr @@ -117,6 +122,7 @@ sudo reboot Doing that you will have all the time a full/ready to go YunoHosts infrastructure for advanced packagers. And if require, you can have some VMs/LXCs runnning the YunoHost testing or YunoHost next Debian main version. ## Having your packages/commits available in each VMs/LXCs + There are several ways to have your freshly created package available from each VMs/LXCs 1- Do an ssh from the YunoHost VM/LXC to a central repository on your computer 2- Having a shared directory available from each VMs, LXCs VirtualBoxs @@ -125,7 +131,7 @@ There are several ways to have your freshly created package available from each Example of a script to mount as shared directory a packaging directory into a VirtualBox VM -``` +```bash #!/bin/bash shared_folder=my_directory @@ -137,7 +143,7 @@ white="\e[97m" blue="\e[34m" echo_info() { - echo -e "[${bold}${blue}INFO${normal}] ${bold}${white}$1${normal}" + echo -e "[${bold}${blue}INFO${normal}] ${bold}${white}$1${normal}" } # Create the main directory for the mount @@ -149,6 +155,7 @@ sudo mount -o defaults -t vboxsf $shared_folder "./$shared_folder" ``` ## Shortcuts + Use and abuse of `yunohost app install` `--args` argument You can do ugly thing considering mynewapp is the name/REPLACEBYYOURAPP of your app @@ -186,8 +193,6 @@ To upgrade your mynewapp ```bash YNHAPP=mynewapp yunohost app upgrade ${YNHAPP} -f /mycentralrepo/${YNHAPP}_ynh/ --debug - - ``` With that, you will be able to launch different actions on differents YunoHost VMs/LXCs @@ -200,5 +205,6 @@ With advanced packaging comes [CI_package_check](https://github.com/YunoHost/CI_ When you do several things at the same time, sometimes you don't remember what is the next step for this or that app. A good tool to keep your TODO list organized is to use a kaban like apps: + - [Kanboard](https://github.com/YunoHost-Apps/kanboard_ynh) - [Wekan](https://github.com/YunoHost-Apps/wekan_ynh) diff --git a/pages/06.contribute/10.packaging_apps/60.advanced/70.notes_about_new_packaging_v2/docs.md b/pages/06.contribute/10.packaging_apps/60.advanced/70.notes_about_new_packaging_v2/docs.md index a9fa9cf2..1ea9183d 100644 --- a/pages/06.contribute/10.packaging_apps/60.advanced/70.notes_about_new_packaging_v2/docs.md +++ b/pages/06.contribute/10.packaging_apps/60.advanced/70.notes_about_new_packaging_v2/docs.md @@ -10,9 +10,10 @@ routes: Packaging v2 is a major improvement for the packaging introduced in YunoHost 11.1 -### Motivation +### Motivation The motivations for this new format is: + - to get rid of some boring or unecessarily complex or duplicateds stuff such as saving/loading settings, creating a system user, etc.. during the install/upgrade/restore script, which are common things accross many apps. - to get rid of funky historical, not-super-semantic stuff such as `__FINALPATH__` being replaced by `$final_path` (with underscore), or `__PATH__` being replaced by `$path_url`, etc. - formalize some aspects such as the existence of the install dir, data dir, apt dependencies, database, etc. which in turn unlock possible future developments such as computing the space used by an app at one given moment, auto-upgrading apt dependencies during Debian major migration, etc. @@ -20,10 +21,10 @@ The motivations for this new format is: However, this "v2" is not the end of the story and should be seen as an intermediate stage before a "v3" packaging. In particular this "v3" packaging should also formalize the handling of the system and app configurations files and ultimately rework the entire paradigm of the install/remove/upgrade/backup/restore scripts. - ### Adapting a v1 app to v2 A script is available in and will attempt to convert what it can from the v1 format to the v2 format, in particular: + - initializing a `manifest.toml` and prefilling it with info scrapped from the various scripts - comment out now-unecessary lines in the various scripts @@ -36,36 +37,36 @@ This will edit the file in place and you should then carefully review and iterat The [example repo](https://github.com/YunoHost/example_ynh) illustrates the below. - **The manifest is now written as toml (`manifest.toml`)** instead of json (`manifest.json`). The structure of the manifest itself has been reworked and now include: - - The `upstream` section (now mandatory) - - An `integration` section meant to formalize what minimum YunoHost version is required, the list of supported architectures, declare if SSO/LDAP is supported, typical resource usage. This is meant to be displayed both in the catalog (similar to app stores) and on the app info page after installing the app - though this is still work in progress. - - A `resource` section (detailed below) + - The `upstream` section (now mandatory) + - An `integration` section meant to formalize what minimum YunoHost version is required, the list of supported architectures, declare if SSO/LDAP is supported, typical resource usage. This is meant to be displayed both in the catalog (similar to app stores) and on the app info page after installing the app - though this is still work in progress. + - A `resource` section (detailed below) - **Install questions are now automatically saved as settings** (except user-provided password and other specific infos) - **All settings are now automatically loaded in app script environments** (so e.g. directly define `$domain`, etc.) - **Auto-enable `set -eu`** a.k.a. `ynh_abort_if_errors` in appropriate scripts - **The safety-backup-before-upgrade is now automatically handled by the core** - **Simplify writing change-url scripts**: old the `new`/`old`/`change` `domain`/`path` are now automatically available in the context and a new helper `ynh_change_url_nginx_config` takes care of tweaking the nginx conf. Your script should essentially just call that helper and possibly tweak the app's conf and possibly restart the app's service - **Introduce a new `resource` mechanism** - - Resources are declared in the `manifest.toml`. - - They are meant to formalize recurring app needs that are to be provisioned/deprovisioned by the core. - - They include for example: system user, apt dependencies, install dir, data dir, port, permissions, SQL database... - - Each resource is to be provisioned *before* running the install script, deprovisioned *after* the remove script, and automatically upgraded if needed before running the upgrade script (or provisionned if introduced in the new app version, or deprovisioned if removed w.r.t. the previous app version) - - More infos about resources and their options and behavior are available in the dedicated doc page + - Resources are declared in the `manifest.toml`. + - They are meant to formalize recurring app needs that are to be provisioned/deprovisioned by the core. + - They include for example: system user, apt dependencies, install dir, data dir, port, permissions, SQL database... + - Each resource is to be provisioned *before* running the install script, deprovisioned *after* the remove script, and automatically upgraded if needed before running the upgrade script (or provisionned if introduced in the new app version, or deprovisioned if removed w.r.t. the previous app version) + - More infos about resources and their options and behavior are available in the dedicated doc page - **Permissions are automatically initialized using the answer to the `init_main_permission` install question** (replacing the `is_public` question). No need to write a boring `if $is_public ...` in the install script to add visitors anymore ! There is a similar mechanism to init other permissions, eg `init_admin_permission` (cf also the doc about the `permission` resource) - **The content of the `doc/` folder is now meant to be integrated in the webadmin** (though this is still WIP as of writing this). In particular: - - `DESCRIPTION.md` and the `screenshots/` folder are expected to be displayed prior to the app install form (similar to app stores on mobile) - - `ADMIN.md` is expected to be made available somewhere in the info page and should contain technical admin notes. Other pages can be defined (just name it `WHATEVER.md`). Lang codes are also supported following the existing scheme for the README, eg `README_fr.md` is the French version, hence you can create `ADMIN_fr.md`, etc. - - Note that the `ADMIN.md` page supports the `__FOOBAR__` notation that will be automatically replaced with the app's `foobar` setting -- **Special files called 'notifications' are meant to replace the `ynh_send_readme_to_admin` mechanics**. They are also to be added to the `doc` folder: - - `doc/PRE_INSTALL.md`: a note to be displayed prior to the app install. Typically to warn of something unusual, such as "the app install will automatically add 1GB swap to the system". - - `doc/POST_INSTALL.md`: a note to be displayed after the app install. Typically to explain post-install operations to be performed manually by the admin and that cannot be automated. - - `doc/PRE_UPGRADE.md`: a note to be displayed prior to any upgrade of this app. - - `doc/PRE_UPGRADE.d/{version}.md`: a note to be displayed prior to a specific version upgrade. - - `doc/POST_UPGRADE.md`: a note to be displayed after the app upgrade. For example in the context of Nextcloud, the fact that you may need to re-enable custom modules manually? - - Note that the notifications, like `ADMIN.md`, supports the `__FOOBAR__` notation that will be automatically replaced with the app's `foobar` setting - - **Replace some historical names with more sensible ones**, or homogenize some practices: - - `final_path` is now `install_dir` (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) - - `datadir` is now `data_dir` to be consistent with `install_dir` (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) - - `path` is now always loaded as `$path`, no funky `$path_url`-but-it-is-saved-as-`path` anymore (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) - - `mysqldbpwd` and `psqlpwd` or whatever are now always saved as `db_pwd` (cf the `database` resource) (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) - - ports settings are now always named either `$port` or `$port_foo_bar` instead of `$foo_bar_port` (cf the `port` resource) (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) - - the install dir is to be set to `/var/www/$app` by default for web apps (or can be changed to `/opt/????` for non-webapps). Note that YunoHost will **automatically move** the old install dir to the new `install_dir` during the corresponding upgrade. + - `DESCRIPTION.md` and the `screenshots/` folder are expected to be displayed prior to the app install form (similar to app stores on mobile) + - `ADMIN.md` is expected to be made available somewhere in the info page and should contain technical admin notes. Other pages can be defined (just name it `WHATEVER.md`). Lang codes are also supported following the existing scheme for the README, eg `README_fr.md` is the French version, hence you can create `ADMIN_fr.md`, etc. + - Note that the `ADMIN.md` page supports the `__FOOBAR__` notation that will be automatically replaced with the app's `foobar` setting +- **Special files called 'notifications' are meant to replace the `ynh_send_readme_to_admin` mechanics**. They are also to be added to the `doc` folder: + - `doc/PRE_INSTALL.md`: a note to be displayed prior to the app install. Typically to warn of something unusual, such as "the app install will automatically add 1GB swap to the system". + - `doc/POST_INSTALL.md`: a note to be displayed after the app install. Typically to explain post-install operations to be performed manually by the admin and that cannot be automated. + - `doc/PRE_UPGRADE.md`: a note to be displayed prior to any upgrade of this app. + - `doc/PRE_UPGRADE.d/{version}.md`: a note to be displayed prior to a specific version upgrade. + - `doc/POST_UPGRADE.md`: a note to be displayed after the app upgrade. For example in the context of Nextcloud, the fact that you may need to re-enable custom modules manually? + - Note that the notifications, like `ADMIN.md`, supports the `__FOOBAR__` notation that will be automatically replaced with the app's `foobar` setting +- **Replace some historical names with more sensible ones**, or homogenize some practices: + - `final_path` is now `install_dir` (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) + - `datadir` is now `data_dir` to be consistent with `install_dir` (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) + - `path` is now always loaded as `$path`, no funky `$path_url`-but-it-is-saved-as-`path` anymore (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) + - `mysqldbpwd` and `psqlpwd` or whatever are now always saved as `db_pwd` (cf the `database` resource) (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) + - ports settings are now always named either `$port` or `$port_foo_bar` instead of `$foo_bar_port` (cf the `port` resource) (this migration should be automatically handled by the core and the `convert_app_to_packaging_v2.py` script) + - the install dir is to be set to `/var/www/$app` by default for web apps (or can be changed to `/opt/????` for non-webapps). Note that YunoHost will **automatically move** the old install dir to the new `install_dir` during the corresponding upgrade. diff --git a/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md b/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md index cee66560..865c988e 100644 --- a/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md +++ b/pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md @@ -30,7 +30,7 @@ extras.yarn.packages = ["yarn"] ##### Properties - `packages`: List of packages to be installed via `apt` -- `packages_from_raw_bash`: A multi-line bash snippet (using triple quotes as open/close) which should echo additional packages to be installed. Meant to be used for packages to be conditionally installed depending on architecture, debian version, install questions, or other logic. +- `packages_from_raw_bash`: A multi-line bash snippet (using triple quotes as open/close) which should echo additional packages to be installed. Meant to be used for packages to be conditionally installed depending on architecture, Debian version, install questions, or other logic. - `extras`: A dict of (repo, key, packages) corresponding to "extra" repositories to fetch dependencies from ##### Provision/Update @@ -306,7 +306,7 @@ Or more complex examples with several element, including one with asset that dep ###### Regarding `autoupdate` -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. +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 : which is ran by the YunoHost infrastructure periodically and will create the corresponding pull request automatically. @@ -326,7 +326,7 @@ And choose one strategy in the following ones: - `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__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__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. +- `latest__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. diff --git a/pages/06.contribute/10.packaging_apps/packaging_apps_intro.de.md b/pages/06.contribute/10.packaging_apps/packaging_apps_intro.de.md index 5779afbb..dec3e55b 100644 --- a/pages/06.contribute/10.packaging_apps/packaging_apps_intro.de.md +++ b/pages/06.contribute/10.packaging_apps/packaging_apps_intro.de.md @@ -85,20 +85,24 @@ Grob gesagt besteht die Installation selbst im Allgemeinen aus den folgenden Vor 2. YunoHost stellt dem Administrator die in `manifest.toml` definierten Fragen zur Installation 3. Der Administrator füllt das Formular aus und startet die Installation 4. YunoHost stellt eine Reihe von technischen Voraussetzungen (genannt 'Ressourcen') bereit, wie z.B.: - - Initialisierung des Schlüssel/Wertspeichers der Anwendung `settings.yml` mit den Antworten des Administrators auf das Installationsformular - - legt einen UNIX-Systembenutzer für diese Anwendung an - - installiert apt-Abhängigkeiten, die für diese Anwendung benötigt werden - - wählt einen Port für internes Reverse-Proxying aus - - initialisiert eine leere SQL-Datenbank - - konfiguriert SSOwat-Berechtigungen - - ... + +- Initialisierung des Schlüssel/Wertspeichers der Anwendung `settings.yml` mit den Antworten des Administrators auf das Installationsformular +- legt einen UNIX-Systembenutzer für diese Anwendung an +- installiert apt-Abhängigkeiten, die für diese Anwendung benötigt werden +- wählt einen Port für internes Reverse-Proxying aus +- initialisiert eine leere SQL-Datenbank +- konfiguriert SSOwat-Berechtigungen +- ... + 5. Das eigentliche Skript `Install` wird ausgeführt und erledigt in der Regel: - - Holen und Bereitstellen der App-Quellen - - die App konfigurieren (typischerweise DB-Anmeldedaten, interner Reverse-Proxy-Port...) - - Hinzufügen der NGINX-Konfiguration - - Hinzufügen der systemd-Konfiguration für den Daemon der Anwendung - - Startet den Daemon der Anwendung - - verschiedene Feinabstimmungen zur Fertigstellung + +- Holen und Bereitstellen der App-Quellen +- die App konfigurieren (typischerweise DB-Anmeldedaten, interner Reverse-Proxy-Port...) +- Hinzufügen der NGINX-Konfiguration +- Hinzufügen der systemd-Konfiguration für den Daemon der Anwendung +- Startet den Daemon der Anwendung +- verschiedene Feinabstimmungen zur Fertigstellung + 6. ??? 7. Die Anwendung ist einsatzbereit! diff --git a/pages/06.contribute/10.packaging_apps/packaging_apps_intro.fr.md b/pages/06.contribute/10.packaging_apps/packaging_apps_intro.fr.md index c9221af7..cd3591ee 100644 --- a/pages/06.contribute/10.packaging_apps/packaging_apps_intro.fr.md +++ b/pages/06.contribute/10.packaging_apps/packaging_apps_intro.fr.md @@ -85,20 +85,24 @@ Grosso modo, l'installation proprement dite se compose généralement des opéra 2. YunoHost pose à l'administrateur les questions d'installation définies dans `manifest.toml`. 3. L'administrateur remplit le formulaire et démarre l'installation. 4. YunoHost fournit un ensemble de pré-requis techniques (appelés 'ressources') tels que : - - initialise le magasin de clés/valeurs de l'application `settings.yml` avec les réponses de l'administrateur au formulaire d'installation - - crée un utilisateur UNIX pour cette application - - installe les dépendances apt nécessaires à cette application - - choisit un port pour le reverse-proxying interne - - initialise une base de données SQL vide - - configure les permissions SSOwat - - ... + +- initialise le magasin de clés/valeurs de l'application `settings.yml` avec les réponses de l'administrateur au formulaire d'installation +- crée un utilisateur UNIX pour cette application +- installe les dépendances apt nécessaires à cette application +- choisit un port pour le reverse-proxying interne +- initialise une base de données SQL vide +- configure les permissions SSOwat +- ... + 5. Le script `install` de l'application est exécuté et ses fonctions typiques sont de : - - récupérer et déployer les sources de l'application - - configurer l'application (typiquement les identifiants de la base de données, le port interne du reverse-proxy...) - - ajouter la configuration de NGINX - - ajoute la configuration systemd du daemon de l'application - - démarre le daemon de l'application - - divers réglages de finalisation + +- récupérer et déployer les sources de l'application +- configurer l'application (typiquement les identifiants de la base de données, le port interne du reverse-proxy...) +- ajouter la configuration de NGINX +- ajoute la configuration systemd du daemon de l'application +- démarre le daemon de l'application +- divers réglages de finalisation + 6. ??? 7. L'application est prête à l'emploi ! diff --git a/pages/06.contribute/10.packaging_apps/packaging_apps_intro.md b/pages/06.contribute/10.packaging_apps/packaging_apps_intro.md index b6e5e9ec..4175018e 100644 --- a/pages/06.contribute/10.packaging_apps/packaging_apps_intro.md +++ b/pages/06.contribute/10.packaging_apps/packaging_apps_intro.md @@ -85,20 +85,24 @@ Roughly speaking, the install itself generally consists of the following operati 2. YunoHost asks to the admin the install questions defined in `manifest.toml` 3. The admin fills the form and starts the install 4. YunoHost provisions a bunch of technical prerequisites (called 'resources') such as: - - initializes the app'skey/value store `settings.yml` with the admin's answers to the install form - - creates a UNIX system user for this app - - install apt dependencies needed for this app - - picks up a port for internal reverse-proxying - - initializes an empty SQL database - - configures SSOwat permissions - - ... + +- initializes the app'skey/value store `settings.yml` with the admin's answers to the install form +- creates a UNIX system user for this app +- install apt dependencies needed for this app +- picks up a port for internal reverse-proxying +- initializes an empty SQL database +- configures SSOwat permissions +- ... + 5. The actual app's `install` script is ran and typically does: - - fetch and deploy the app sources - - configure the app (typically DB credentials, internal reverse-proxy port...) - - add the NGINX configuration - - add the systemd configuration the app's daemon - - starts the app daemon - - various finialization tweaks + +- fetch and deploy the app sources +- configure the app (typically DB credentials, internal reverse-proxy port...) +- add the NGINX configuration +- add the systemd configuration the app's daemon +- starts the app daemon +- various finialization tweaks + 6. ??? 7. Application is ready to use! diff --git a/pages/06.contribute/15.dev/03.forms/forms.md b/pages/06.contribute/15.dev/03.forms/forms.md index f375cda3..b2df7d0f 100644 --- a/pages/06.contribute/15.dev/03.forms/forms.md +++ b/pages/06.contribute/15.dev/03.forms/forms.md @@ -33,7 +33,7 @@ YunoHost uses a lot of forms. You can found here information on supported types | `bind` | AppConfigPanel | See [App configuration panel doc](/packaging_config_panels) | `bind = "__INSTALL_DIR__/config.yml"` | - `help`, `optional`, `readonly` and `visible` are also available on panels and sections entities. -- Long help messages could not to be correctly displayed for user using yunohost CLI +- Long help messages could not to be correctly displayed for user using YunoHost CLI - For the moment `default` properties are not supported in app config panel and you have to initialize the value by yourself in config file or settings. ### `display_text` (readonly) diff --git a/pages/06.contribute/15.dev/dev.fr.md b/pages/06.contribute/15.dev/dev.fr.md index 66a674a9..9c64e74d 100644 --- a/pages/06.contribute/15.dev/dev.fr.md +++ b/pages/06.contribute/15.dev/dev.fr.md @@ -19,9 +19,9 @@ Si vous cherchez quelque chose à implémenter ou un bug à réparer, le bug tra - **Implémentez et testez votre fonctionnalité**. Suivant ce sur quoi vous voulez travailler : - - **Cœur Python/ligne de commande** : allez dans `/ynh-dev/yunohost/` - - **Webadmin** : allez dans `/ynh-dev/yunohost-admin/` - - Vous pouvez aussi travailler sur les autres projets liés sur lesquels s'appuie YunoHost (SSOwat, Moulinette) de façon similaire. + - **Cœur Python/ligne de commande** : allez dans `/ynh-dev/yunohost/` + - **Webadmin** : allez dans `/ynh-dev/yunohost-admin/` + - Vous pouvez aussi travailler sur les autres projets liés sur lesquels s'appuie YunoHost (SSOwat, Moulinette) de façon similaire. ### Vue d'ensemble des 4 morceaux principaux de YunoHost @@ -36,6 +36,7 @@ Moulinette dispose de sa propre documentation [ici](https://moulinette.readthedo ##### YunoHost C'est le cœur même de YunoHost. Il contient : + - [le code Python](https://github.com/YunoHost/yunohost/tree/dev/src) qui gère les utilisateurs, domaines, applications, services et autres - des [helpers bash](https://github.com/YunoHost/yunohost/tree/dev/helpers) principalement utilisés par les packageurs d'applications dans les scripts de ces applications - des [hooks](https://github.com/YunoHost/yunohost/tree/dev/hooks) et [templates](https://github.com/YunoHost/yunohost/tree/dev/conf) qui sont utilisés pour configurer les différents éléments de l'écosystème tels que NGINX, Postfix... @@ -45,6 +46,7 @@ C'est le cœur même de YunoHost. Il contient : ##### SSOwat C'est le système de connexion unique (single sign-on) de YunoHost. Il contient principalement : + - [du code LUA](https://github.com/YunoHost/ssowat) interfacé directement avec NGINX et qui gère tous les aspects "techniques" de l'authentification et de la gestion des accès aux ressources. - le [portail web utilisateur](https://github.com/YunoHost/SSOwat/tree/dev/portal) qui est l'interface finale visible par les utilisateurs de YunoHost. @@ -55,6 +57,7 @@ SSOwat est configuré via `/etc/ssowat/conf.json` qui est généré par YunoHost C'est une dépendance *optionnelle* de YunoHost et correspond à une interface pour l'API web créée par YunoHost et Moulinette (service `yunohost-api`). Il contient essentiellement : + - [des templates pour les vues](https://github.com/YunoHost/yunohost-admin/tree/dev/app/src/views) - les [contrôleurs JavaScript](https://github.com/YunoHost/yunohost-admin/tree/dev/src/js/yunohost/controllers) correspondants, qui interagissent avec l'API YunoHost - et ses [chaînes internationalisées](https://github.com/YunoHost/yunohost-admin/tree/dev/app/src/i18n/locales) @@ -100,8 +103,7 @@ Il contient essentiellement : - Il faudra peut-être régulièrement forcer le rafraîchissement du cache navigateur pour propager correctement le JavaScript et/ou HTML (à chaque fois que l'on change quelque chose dans `js` ou `views`, donc). - -### Votre fonctionnalité est prête et vous souhaitez qu'elle soit intégrée dans YunoHost +### Votre fonctionnalité est prête et vous souhaitez qu'elle soit intégrée dans YunoHost - Forkez le dépôt correspondant sur GitHub, et commitez vos changements dans une nouvelle branche. Il est recommandé de nommer la branche avec la convention suivante : - Pour une nouvelle fonctionnalité ou amélioration : `enh-ISSUENUMBER-description-fonctionnalité` diff --git a/pages/06.contribute/15.dev/dev.md b/pages/06.contribute/15.dev/dev.md index b3d26255..a68e8b70 100644 --- a/pages/06.contribute/15.dev/dev.md +++ b/pages/06.contribute/15.dev/dev.md @@ -9,9 +9,9 @@ routes: You wish to add a new feature in the YunoHost core, but don't know how to proceed? This guide takes you through the various steps of the development and -contribution process. +contribution process. -If you're looking for stuff to implement or fix, the bug-tracker is +If you're looking for stuff to implement or fix, the bug-tracker is [here](https://github.com/YunoHost/issues/issues)! **Come say hi to us in the [dev chat room](/chat_rooms)**! @@ -26,18 +26,18 @@ If you're looking for stuff to implement or fix, the bug-tracker is - **Implement and test your feature**. Depending on what you want to develop, you will want to: - - **Python/CLI core**: work in `/ynh-dev/yunohost/` - - **Web administration interface**: work in `/ynh-dev/yunohost-admin/` - - You can also work on the other projects on which YunoHost is built + - **Python/CLI core**: work in `/ynh-dev/yunohost/` + - **Web administration interface**: work in `/ynh-dev/yunohost-admin/` + - You can also work on the other projects on which YunoHost is built (SSOwat, Moulinette) in similar ways ### Overview of the 4 main pieces of YunoHost #### Moulinette -It is a small "homemade" framework. [Its major role](https://moulinette.readthedocs.io/en/latest/actionsmap.html) -is to allow us to build both a web API and a command-line API from the same -Python code thanks to a YAML schema which we call +It is a small "homemade" framework. [Its major role](https://moulinette.readthedocs.io/en/latest/actionsmap.html) +is to allow us to build both a web API and a command-line API from the same +Python code thanks to a YAML schema which we call [the actionmap](https://github.com/YunoHost/yunohost/blob/dev/share/actionsmap.yml). It handles other mechanisms like authentication, internationalization and @@ -48,6 +48,7 @@ Moulinette has its own documentation available [here](https://moulinette.readthe #### YunoHost This piece is the very core of YunoHost. It contains: + - [the Python code](https://github.com/YunoHost/yunohost/tree/dev/src) that manages users, domains, apps, services and other things - [bash helpers](https://github.com/YunoHost/yunohost/tree/dev/helpers) mainly used by application packagers to package applications - [hooks](https://github.com/YunoHost/yunohost/tree/dev/hooks) and [templates](https://github.com/YunoHost/yunohost/tree/dev/conf) that are used to configure the various pieces of the ecosystem such as NGINX, Postfix... @@ -57,6 +58,7 @@ This piece is the very core of YunoHost. It contains: #### SSOwat This is the single sign-on system of YunoHost. It both contains: + - [Lua scripts](https://github.com/YunoHost/ssowat) that are directly interfaced with NGINX and handle all the "technical" aspects of authentication and route accesses - the web [user portal](https://github.com/YunoHost/SSOwat/tree/dev/portal) which is the interface used by YunoHost's end users to log in and browse installed apps @@ -67,6 +69,7 @@ SSOwat is configured through `/etc/ssowat/conf.json` which is generated by YunoH It is an *optional* dependency of YunoHost and corresponds to an interface for the web API created by YunoHost and Moulinette (c.f. the `yunohost-api` service). It essentially contains: + - [view templates](https://github.com/YunoHost/yunohost-admin/tree/dev/app/src/views) - corresponding [JavaScript controllers](https://github.com/YunoHost/yunohost-admin/tree/dev/src/js/yunohost/controllers) that interact with the YunoHost API - and [internationalized strings](https://github.com/YunoHost/yunohost-admin/tree/dev/app/src/i18n/locales) @@ -78,7 +81,7 @@ It essentially contains: - Run `cd /ynh_dev/ && ./ynh-dev use-git yunohost`. - The actionsmap file (`data/actionsmap/yunohost.yml`) defines the various - categories, actions and arguments of the yunohost CLI. Define how you want + categories, actions and arguments of the YunoHost CLI. Define how you want users to use your feature, and add/edit the corresponding categories, actions and arguments. For example in `yunohost domain add some.domain.tld`, the category is `domain`, the action is `add`, and `some.domain.tld` is an @@ -108,8 +111,8 @@ It essentially contains: - Work in `/ynh-dev/yunohost-admin/src/`. -- Run `cd /ynh-dev && ./ynh-dev use-git yunohost-admin`. It launches gulp, such as each - time you modify sources, it recompiles the code and you can use it by +- Run `cd /ynh-dev && ./ynh-dev use-git yunohost-admin`. It launches gulp, such as each + time you modify sources, it recompiles the code and you can use it by refreshing (Ctrl+F5) your web administration. To stop the command, just do Ctrl+C. - The web interface uses the API to interact with YunoHost. The API @@ -144,10 +147,9 @@ It essentially contains: `systemctl restart yunohost-api` (You'll need to retype your admin and password in the web interface) -- You might need to force-clear the cache of your browser sometimes to refresh +- You might need to force-clear the cache of your browser sometimes to refresh the JavaScript and/or HTML (so each time you edit something in `js` or `views`). - ### Your feature is ready and you want it to be integrated in YunoHost - Fork the relevant repo on GitHub, and commit stuff to a new branch. We recommend @@ -156,7 +158,7 @@ It essentially contains: - For a bugfix `fix-ISSUENUMBER-description-of-fix` - `ISSUENUMBER` is optional and is the id of a corresponding ticket on the bug tracker. -- Once you're ready, open a Pull Request (PR) on GitHub. Please include `[fix]` or +- Once you're ready, open a Pull Request (PR) on GitHub. Please include `[fix]` or `[enh]` at the beginning of the title of your PR. - After reviewing, testing and validation by other contributors, your branch diff --git a/pages/06.contribute/contribute.de.md b/pages/06.contribute/contribute.de.md index d26d9ee1..6057feff 100644 --- a/pages/06.contribute/contribute.de.md +++ b/pages/06.contribute/contribute.de.md @@ -23,7 +23,7 @@ YunoHost hängt ausschließlich von der Beteiligung von Leuten wie dir ab. [/center] [center] -Sprich mit Freunden, Verwandten und bei der Arbeit über Softwarefreiheit, [Selbsthosting](/selfhosting) und YunoHost. Wir verlassen uns auf Evangelisten der Datenfreiheit wie dich. <3 +Sprich mit Freunden, Verwandten und bei der Arbeit über Softwarefreiheit, [Selbsthosting](/selfhosting) und YunoHost. Wir verlassen uns auf Evangelisten der Datenfreiheit wie dich. <3 [/center] [/columns] @@ -37,7 +37,7 @@ Sprich mit Freunden, Verwandten und bei der Arbeit über Softwarefreiheit, [Selb [/center] [center] -Unsere Unterstützung basiert auf Mitwirkenden wie dir. Besuche einfach [den Support-Chatroom](/help) und hilf neuen Benutzern beim Einstieg oder suche dir eine Frage im Forum, bei der du helfen kannst.. +Unsere Unterstützung basiert auf Mitwirkenden wie dir. Besuche einfach [den Support-Chatroom](/help) und hilf neuen Benutzern beim Einstieg oder suche dir eine Frage im Forum, bei der du helfen kannst.. [/center] [/columns] @@ -51,7 +51,7 @@ Unsere Unterstützung basiert auf Mitwirkenden wie dir. Besuche einfach [den Sup [/center] [center] -Verbessere die Dokumentation, indem du [neue Seiten schreibst](/write_documentation) oder vorhandene in deine Sprache übersetzt. +Verbessere die Dokumentation, indem du [neue Seiten schreibst](/write_documentation) oder vorhandene in deine Sprache übersetzt. [/center] [/columns] @@ -66,7 +66,7 @@ Verbessere die Dokumentation, indem du [neue Seiten schreibst](/write_documentat [center] Mach mit, indem du YunoHost-Schnittstellen in deiner Sprache verfügbar machst. -Leg los!! +Leg los!! [/center] [/columns] @@ -81,7 +81,7 @@ Mach mit, indem du YunoHost-Schnittstellen in deiner Sprache verfügbar machst. [center] -Wir brauchen Leute, die YunoHost gründlich testen. Wenn du einen Fehler findest, versuche ihn zu identifizieren und melde ihn in unserem bug tracker. +Wir brauchen Leute, die YunoHost gründlich testen. Wenn du einen Fehler findest, versuche ihn zu identifizieren und melde ihn in unserem bug tracker. [/center] [/columns] @@ -96,7 +96,7 @@ Wir brauchen Leute, die YunoHost gründlich testen. Wenn du einen Fehler findest [center] Erweitere den Funktionsumfang von YunoHost, indem du neue [Dienste und Webanwendungen in neue Pakete packst](/packaging_apps). -Schaue dir an, [was schon getan wurde](/apps)! +Schaue dir an, [was schon getan wurde](/apps)! [/center] [/columns] @@ -112,15 +112,16 @@ Schaue dir an, [was schon getan wurde](/apps)! [center] Du kannst dich, unabhängig von deinen Fähigkeiten, an der Entwicklung des YunoHost beteiligen. -Sysadmins, Webentwickler, Designer und Pythonisten sind herzlich willkommen! +Sysadmins, Webentwickler, Designer und Pythonisten sind herzlich willkommen!
-Erfahre im [Entwickler-Chatroom](xmpp:dev@conference.yunohost.org?join), wie du zum, Projekt [beitragen](/dev) kannst. +Erfahre im [Entwickler-Chatroom](xmpp:dev@conference.yunohost.org?join), wie du zum, Projekt [beitragen](/dev) kannst. [/center] [/columns] - --- [center] + ### Bitte komm auf jeden Fall mit uns in den [Entwickler-Chatroom](/chat_rooms) :-) + [/center] diff --git a/pages/06.contribute/contribute.fr.md b/pages/06.contribute/contribute.fr.md index c34cb505..7ac17a07 100644 --- a/pages/06.contribute/contribute.fr.md +++ b/pages/06.contribute/contribute.fr.md @@ -14,7 +14,6 @@ routes: YunoHost dépend entièrement de la participation de gens comme vous.

-
[columns] @@ -39,7 +38,7 @@ Parlez de logiciel libre, d’[auto-hébergement](/selfhosting), de YunoHost à [/center] [center] -Notre support est communautaire et s’appuie sur des contributeurices comme vous. Venez simplement sur le [salon d'aide](/help), ou tentez de répondre aux questions du Forum. +Notre support est communautaire et s’appuie sur des contributeurices comme vous. Venez simplement sur le [salon d'aide](/help), ou tentez de répondre aux questions du Forum. [/center] [/columns] @@ -67,7 +66,7 @@ Améliorez cette documentation en [proposant de nouvelles pages](/write_document [/center] [center] -Participez en rendant les interfaces de YunoHost disponibles dans votre langue. Lancez-vous ! +Participez en rendant les interfaces de YunoHost disponibles dans votre langue. Lancez-vous ! [/center] [/columns] @@ -81,7 +80,7 @@ Participez en rendant les interfaces de YunoHost disponibles dans votre langue. [/center] [center] -Nous avons besoin de tester YunoHost profondément. Si vous trouvez un bug, essayez de l’identifier, puis reportez-le sur notre bug tracker. +Nous avons besoin de tester YunoHost profondément. Si vous trouvez un bug, essayez de l’identifier, puis reportez-le sur notre bug tracker. [/center] [/columns] @@ -109,12 +108,14 @@ Nous avons besoin de tester YunoHost profondément. Si vous trouvez un bug, essa [/center] [center] -Vous pouvez vous impliquer dans le développement de YunoHost peu importe votre niveau. Administrateurs système, développeurs web, designers et pythonistes sont les bienvenus. Découvrez [comment contribuer](/dev), et rejoignez-nous sur le [salon de discussion](xmpp:dev@conference.yunohost.org?join) ! +Vous pouvez vous impliquer dans le développement de YunoHost peu importe votre niveau. Administrateurs système, développeurs web, designers et pythonistes sont les bienvenus. Découvrez [comment contribuer](/dev), et rejoignez-nous sur le [salon de discussion](xmpp:dev@conference.yunohost.org?join) ! [/center] [/columns] --- [center] + ### Dans tous les cas, venez discuter avec nous sur [le salon de développement](/chat_rooms) :-) + [/center] diff --git a/pages/06.contribute/contribute.md b/pages/06.contribute/contribute.md index 00a70704..f4e78d48 100644 --- a/pages/06.contribute/contribute.md +++ b/pages/06.contribute/contribute.md @@ -37,7 +37,7 @@ Talk about software freedom, [self-hosting](/selfhosting) and YunoHost to your r [/center] [center] -Our support relies on contributors like you. Just come to [the support chatroom](/help) and help new users getting started, or pick a question on the Forum. +Our support relies on contributors like you. Just come to [the support chatroom](/help) and help new users getting started, or pick a question on the Forum. [/center] [/columns] @@ -66,7 +66,7 @@ Improve this documentation by [writing new pages](/write_documentation) or trans [center] Get involved by making YunoHost interfaces available in your language -Get started! +Get started! [/center] [/columns] @@ -80,7 +80,7 @@ Get involved by making YunoHost interfaces available in your language [/center] [center] -We need people able to test YunoHost deeply. If you find a bug, try to identify it, and report it on our bug tracker. +We need people able to test YunoHost deeply. If you find a bug, try to identify it, and report it on our bug tracker. [/center] [/columns] @@ -110,14 +110,15 @@ Have a look of [what has been done yet](/apps)! [center] You can involve in the YunoHost's development regardless of your skill. -Sysadmins, web developers, designers and pythonists are welcome! +Sysadmins, web developers, designers and pythonists are welcome! Learn [how to contribute](/dev), and join us on the [development chat room](xmpp:dev@conference.yunohost.org?join). [/center] [/columns] - --- [center] + ### In any case, please come chat with us on [the dev chatroom](/chat_rooms) :-) + [/center]