mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
second formater pass
This commit is contained in:
parent
b190487475
commit
a9774ac8a5
111 changed files with 816 additions and 735 deletions
|
@ -54,9 +54,10 @@
|
||||||
"code_blocks": false,
|
"code_blocks": false,
|
||||||
"names": [
|
"names": [
|
||||||
"YunoHost",
|
"YunoHost",
|
||||||
"Debian",
|
|
||||||
"GitHub"
|
"GitHub"
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
"line-length": false
|
"line-length": false,
|
||||||
|
"no-reversed-links": false,
|
||||||
|
"no-missing-space-atx": false
|
||||||
}
|
}
|
|
@ -23,7 +23,7 @@ YunoHost ist ein **Betriebssystem**, das auf die einfachste Verwaltung eines **S
|
||||||
-  Enthält einen **vollständigen E-Mail-Stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
|
-  Enthält einen **vollständigen E-Mail-Stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
|
||||||
-  … sowie **einen Instant Messaging Server** <small>(XMPP)</small> ;
|
-  … sowie **einen Instant Messaging Server** <small>(XMPP)</small> ;
|
||||||
-  Verwaltet **SSL-Zertifikate** <small>(basierend auf Let's Encrypt)</small> ;
|
-  Verwaltet **SSL-Zertifikate** <small>(basierend auf Let's Encrypt)</small> ;
|
||||||
-  … und **Sicherheitssysteme** <small>(fail2ban, yunohost-firewall)</small> ;
|
-  … und **Sicherheitssysteme** <small>(`fail2ban`, `yunohost-firewall`)</small> ;
|
||||||
|
|
||||||
## Ursprung
|
## Ursprung
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ YunoHost es un **sistema operativo** que persigue simplificar la administración
|
||||||
-  Incluye un **servidor de correo electrónico completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
|
-  Incluye un **servidor de correo electrónico completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
|
||||||
-  … así como un **servidor de mensajería instanea** <small>(XMPP)</small> ;
|
-  … así como un **servidor de mensajería instanea** <small>(XMPP)</small> ;
|
||||||
-  Administra **certificados SSL** <small>(generados por Let's Encrypt)</small> ;
|
-  Administra **certificados SSL** <small>(generados por Let's Encrypt)</small> ;
|
||||||
-  … y los **sistemas de seguridad** <small>(fail2ban, yunohost-firewall)</small> ;
|
-  … y los **sistemas de seguridad** <small>(`fail2ban`, `yunohost-firewall`)</small> ;
|
||||||
|
|
||||||
## Origen
|
## Origen
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ YunoHost est un **système d’exploitation** qui vise à simplifier autant que
|
||||||
-  fourni avec un **serveur mail complet** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
|
-  fourni avec un **serveur mail complet** <small>(Postfix, Dovecot, Rspamd, DKIM)</small> ;
|
||||||
-  ... ainsi qu'un **serveur de messagerie instantanée** <small>(XMPP)</small> ;
|
-  ... ainsi qu'un **serveur de messagerie instantanée** <small>(XMPP)</small> ;
|
||||||
-  gère les **certificats SSL** <small>(basé sur Let's Encrypt)</small> ;
|
-  gère les **certificats SSL** <small>(basé sur Let's Encrypt)</small> ;
|
||||||
-  ... et des **systèmes de sécurité** <small>(Fail2Ban, yunohost-firewall)</small> ;
|
-  ... et des **systèmes de sécurité** <small>(`fail2ban`, `yunohost-firewall`)</small> ;
|
||||||
|
|
||||||
## Origine
|
## Origine
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ YunoHost è un **sistema operativo** che mira a rendere il più semplice possibi
|
||||||
-  Include uno **stack di posta elettronica completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
-  Include uno **stack di posta elettronica completo** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
||||||
- ... e anche un **server di messaggistica istantanea** <small>(XMPP)</small>;
|
- ... e anche un **server di messaggistica istantanea** <small>(XMPP)</small>;
|
||||||
-  Gestisce i **certificati SSL** <small>(basati su Let's Encrypt)</small> ;
|
-  Gestisce i **certificati SSL** <small>(basati su Let's Encrypt)</small> ;
|
||||||
- ... e i **sistemi di sicurezza** <small>(Fail2ban, yunohost-firewall)</small>;
|
- ... e i **sistemi di sicurezza** <small>(`fail2ban`, `yunohost-firewall`)</small>;
|
||||||
|
|
||||||
## Origine
|
## Origine
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ YunoHost is an **operating system** aiming for the simplest administration of a
|
||||||
-  Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
-  Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
||||||
- ... as well as **an instant messaging server** <small>(XMPP)</small>;
|
- ... as well as **an instant messaging server** <small>(XMPP)</small>;
|
||||||
-  Manages **SSL certificates** <small>(based on Let's Encrypt)</small> ;
|
-  Manages **SSL certificates** <small>(based on Let's Encrypt)</small> ;
|
||||||
- ... and **security systems** <small>(Fail2ban, yunohost-firewall)</small>;
|
- ... and **security systems** <small>(`fail2ban`, `yunohost-firewall`)</small>;
|
||||||
|
|
||||||
## Origin
|
## Origin
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ YunoHost это **операционная система** позволяюща
|
||||||
-  Включает **полный набор для работы электронной почты** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
-  Включает **полный набор для работы электронной почты** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
||||||
- ... более известный как **встроенный сервер сообщений** <small>(XMPP)</small>;
|
- ... более известный как **встроенный сервер сообщений** <small>(XMPP)</small>;
|
||||||
-  Управляй **SSL сертификатами** <small>(Основано на Let's Encrypt)</small> ;
|
-  Управляй **SSL сертификатами** <small>(Основано на Let's Encrypt)</small> ;
|
||||||
- ... и **системами безопасности** <small>(Fail2ban, yunohost-firewall)</small>;
|
- ... и **системами безопасности** <small>(`fail2ban`, `yunohost-firewall`)</small>;
|
||||||
|
|
||||||
## История
|
## История
|
||||||
|
|
||||||
|
|
|
@ -48,8 +48,8 @@ Bildschirm auf den Server anschliessen, sich einloggen und diesen Befehl eingebe
|
||||||
|
|
||||||
Die Standard-Anmeldedaten (vor der Nachinstallation!) zum Einloggen sind:
|
Die Standard-Anmeldedaten (vor der Nachinstallation!) zum Einloggen sind:
|
||||||
|
|
||||||
- login: root
|
- login: `root`
|
||||||
- password: yunohost
|
- password: `yunohost`
|
||||||
|
|
||||||
(Wenn Sie ein rohes Armbian-Image anstelle des vorinstallierten YunoHost-Images verwenden, lauten die Anmeldedatenen root / 1234)
|
(Wenn Sie ein rohes Armbian-Image anstelle des vorinstallierten YunoHost-Images verwenden, lauten die Anmeldedatenen root / 1234)
|
||||||
|
|
||||||
|
|
|
@ -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 :
|
Les identifiants par défaut (avant la post-installation!) sont :
|
||||||
|
|
||||||
- login : root
|
- login : `root`
|
||||||
- mot de passe : yunohost
|
- 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)
|
(Si vous utilisez une image Armbian brute plutôt que les images YunoHost pré-installées, les identifiants sont root / 1234)
|
||||||
|
|
||||||
|
|
|
@ -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:
|
The default credentials (before post-installation!) to log in are:
|
||||||
|
|
||||||
- login: root
|
- login: `root`
|
||||||
- password: yunohost
|
- password: `yunohost`
|
||||||
|
|
||||||
(If you are using a raw Armbian image instead of the pre-installed YunoHost image, the credentials are root / 1234)
|
(If you are using a raw Armbian image instead of the pre-installed YunoHost image, the credentials are root / 1234)
|
||||||
|
|
||||||
|
|
|
@ -48,8 +48,8 @@ routes:
|
||||||
|
|
||||||
Учетные данные по умолчанию (перед постустановкой!) для входа в систему:
|
Учетные данные по умолчанию (перед постустановкой!) для входа в систему:
|
||||||
|
|
||||||
- логин: root
|
- логин: `root`
|
||||||
- пароль: yunohost
|
- пароль: `yunohost`
|
||||||
|
|
||||||
(Если вы используете необработанный образ Armbian вместо предустановленного образа YunoHost, учетные данные - root / 1234)
|
(Если вы используете необработанный образ Armbian вместо предустановленного образа YunoHost, учетные данные - root / 1234)
|
||||||
|
|
||||||
|
|
|
@ -25,6 +25,7 @@ Ihre Box/Router-Administrationsoberfläche ist in der Regel erreichbar über [ht
|
||||||
### 2. Die lokale IP Ihres Servers finden
|
### 2. Die lokale IP Ihres Servers finden
|
||||||
|
|
||||||
Identifizieren Sie die lokale IP Ihres Servers, entweder :
|
Identifizieren Sie die lokale IP Ihres Servers, entweder :
|
||||||
|
|
||||||
- von Ihrer Box/Router-Schnittstelle, die möglicherweise angeschlossene Geräte auflistet
|
- 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.
|
- ü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
|
- 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.
|
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 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
||||||
* [SSH](/ssh): 22
|
- [SSH](/ssh): 22
|
||||||
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
|
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
|
||||||
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
||||||
|
|
||||||
Wenn Sie sowohl ein Modem als auch einen Router verwenden, dann müssen Sie Folgendes tun:
|
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;
|
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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -21,16 +21,17 @@ El esquema aquí abajo intenta explicar brevemente el rol de la redirección de
|
||||||
|
|
||||||
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 :
|
||||||
|
|
||||||
<a class="btn btn-default" href="http://ports.yunohost.org">Comprobar la redirección de los puertos</a>
|
<a class="btn btn-default" href="http://ports.YunoHost.org">Comprobar la redirección de los puertos</a>
|
||||||
|
|
||||||
### 1. Acceder a la interfaz de administración de tu router/caja/box
|
### 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 <http://192.168.0.1> o <http://192.168.1.1>.
|
||||||
Luego, es posible que tengas que autenticarte con los ID provechos pour tu proveedor de acceso a Internet.
|
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
|
### 2. Descubrir la IP local del servidor
|
||||||
|
|
||||||
Identifica cuál es la IP local de tu servidor, o sea :
|
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 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 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}'`
|
- 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.
|
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 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
||||||
* [SSH](/ssh): 22
|
- [SSH](/ssh): 22
|
||||||
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
|
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
|
||||||
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
||||||
|
|
||||||
! [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.
|
! [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 :
|
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
|
```bash
|
||||||
sudo yunohost firewall reload
|
sudo yunohost firewall reload
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -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
|
### 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 <http://192.168.0.1> ou <http://192.168.1.1>.
|
||||||
Ensuite, il vous faudra peut-être vous authentifier avec les identifiants
|
Ensuite, il vous faudra peut-être vous authentifier avec les identifiants
|
||||||
fournis par votre fournisseur d'accès à Internet (FAI).
|
fournis par votre fournisseur d'accès à Internet (FAI).
|
||||||
|
|
||||||
### 3. Trouver l'IP locale de votre serveur
|
### 3. Trouver l'IP locale de votre serveur
|
||||||
|
|
||||||
Identifiez quelle est l'IP locale de votre serveur, soit :
|
Identifiez quelle est l'IP locale de votre serveur, soit :
|
||||||
|
|
||||||
- depuis l'interface de votre routeur/box, qui liste peut-être les dispositifs
|
- depuis l'interface de votre routeur/box, qui liste peut-être les dispositifs
|
||||||
connectés;
|
connectés;
|
||||||
- depuis la webadmin de YunoHost, dans 'Diagnostic', section 'Connectivité Internet', cliquer sur 'Détails' à côté de la ligne sur IPv4.
|
- 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.
|
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 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
||||||
* [SSH](/ssh): 22
|
- [SSH](/ssh): 22
|
||||||
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(serveurs)</small>
|
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(serveurs)</small>
|
||||||
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
||||||
|
|
||||||
! [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.
|
! [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.
|
||||||
|
|
||||||
|
|
|
@ -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
|
### 2. Find the local IP of your server
|
||||||
|
|
||||||
Identify what is thei *local* IP of your server, either :
|
Identify what is thei *local* IP of your server, either :
|
||||||
|
|
||||||
- from your box/router interface, which might list devices connected
|
- 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 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`
|
- 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.
|
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 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
- Web: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
||||||
* [SSH](/ssh): 22
|
- [SSH](/ssh): 22
|
||||||
* [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
|
- [XMPP](/XMPP): 5222 <small>(clients)</small>, 5269 <small>(servers)</small>
|
||||||
* [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
- [Email](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
||||||
|
|
||||||
If you use both a modem and a router, then you need to do the following:
|
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;
|
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.
|
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
|
```bash
|
||||||
sudo yunohost firewall reload
|
sudo yunohost firewall reload
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -24,6 +24,7 @@ routes:
|
||||||
### 2. Найдите локальный IP-адрес вашего сервера
|
### 2. Найдите локальный IP-адрес вашего сервера
|
||||||
|
|
||||||
Определите, каков *локальный* IP вашего сервера, либо :
|
Определите, каков *локальный* IP вашего сервера, либо :
|
||||||
|
|
||||||
- из вашего интерфейса box / router, в котором может быть список подключенных устройств
|
- из вашего интерфейса box / router, в котором может быть список подключенных устройств
|
||||||
- в веб-администраторе YunoHost, в разделе "Диагностика", "Подключение к Интернету", нажмите "Подробности" в отчете IPv4.
|
- в веб-администраторе YunoHost, в разделе "Диагностика", "Подключение к Интернету", нажмите "Подробности" в отчете IPv4.
|
||||||
- из командной строки на вашем сервере, запустив `hostname -I`
|
- из командной строки на вашем сервере, запустив `hostname -I`
|
||||||
|
@ -38,12 +39,13 @@ routes:
|
||||||
|
|
||||||
Открытие перечисленных ниже портов необходимо для работы различных сервисов, доступных в YunoHost. Для каждого из них необходима переадресация "TCP". Некоторые интерфейсы относятся к "внешним" и "внутренним" портам: в нашем случае это одно и то же.
|
Открытие перечисленных ниже портов необходимо для работы различных сервисов, доступных в YunoHost. Для каждого из них необходима переадресация "TCP". Некоторые интерфейсы относятся к "внешним" и "внутренним" портам: в нашем случае это одно и то же.
|
||||||
|
|
||||||
* Веб: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
- Веб: 80 <small>(HTTP)</small>, 443 <small>(HTTPS)</small>
|
||||||
* [SSH](/ssh): 22
|
- [SSH](/ssh): 22
|
||||||
* [XMPP](/XMPP): 5222 <small>(клиенты)</small>, 5269 <small>(серверы)</small>
|
- [XMPP](/XMPP): 5222 <small>(клиенты)</small>, 5269 <small>(серверы)</small>
|
||||||
* [Почтовые](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
- [Почтовые](/email): 25, 587 <small>(SMTP)</small>, 993 <small>(IMAP)</small>
|
||||||
|
|
||||||
Если вы используете и модем, и маршрутизатор, то вам необходимо выполнить следующее:
|
Если вы используете и модем, и маршрутизатор, то вам необходимо выполнить следующее:
|
||||||
|
|
||||||
1. сначала на модеме (поле, расположенном ближе всего к Интернету) создайте правила для перенаправления вышеуказанных портов на ваш маршрутизатор;
|
1. сначала на модеме (поле, расположенном ближе всего к Интернету) создайте правила для перенаправления вышеуказанных портов на ваш маршрутизатор;
|
||||||
2. затем на маршрутизаторе (поле между модемом и вашими устройствами) создайте правила для пересылки вышеуказанных портов на статический IP-адрес вашего сервера.
|
2. затем на маршрутизаторе (поле между модемом и вашими устройствами) создайте правила для пересылки вышеуказанных портов на статический IP-адрес вашего сервера.
|
||||||
|
|
||||||
|
@ -56,4 +58,3 @@ routes:
|
||||||
```bash
|
```bash
|
||||||
sudo yunohost firewall reload
|
sudo yunohost firewall reload
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -18,7 +18,7 @@ Domain über die Schnittstelle Ihres Registrars konfigurieren.
|
||||||
|
|
||||||
## Empfohlene DNS-Konfiguration
|
## 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 :
|
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 | mail._domainkey | `"v=DKIM1; k=rsa; p=irgendeingrooßerSchlüssel"` |
|
||||||
| TXT | _dmarc | `"v=DMARC1; p=none"` |
|
| 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;
|
- 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 ;) ;
|
- 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
|
Domänename `domain.tld` ist, sollten Sie mit dem Befehl
|
||||||
`nslookup` das folgende Ergebnis erhalten :
|
`nslookup` das folgende Ergebnis erhalten :
|
||||||
|
|
||||||
```shell
|
```bash
|
||||||
$ nslookup 111.222.333.444
|
nslookup 111.222.333.444
|
||||||
444.333.222.111.in-addr.arpa name = domain.tld.
|
444.333.222.111.in-addr.arpa name = domain.tld.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -15,7 +15,7 @@ Si utilizas un [dominio automático](/dns_nohost_me) provecho por el Proyecto Yu
|
||||||
|
|
||||||
## Configuración DNS recomendada
|
## 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 :
|
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 | mail._domainkey | `"v=DKIM1; k=rsa; p=uneGrannnndeClef"` |
|
||||||
| TXT | _dmarc | `"v=DMARC1; p=none"` |
|
| 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.
|
- 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 ;) ;
|
- El punto al final de `tu.dominio.tld.` es importante ;) ;
|
||||||
|
|
|
@ -23,7 +23,7 @@ domaine via l'interface de votre registrar.
|
||||||
|
|
||||||
## Configuration DNS recommandée
|
## 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 :
|
YunoHost fournit une configuration DNS recommandée, accessible via :
|
||||||
|
|
||||||
|
@ -86,7 +86,7 @@ suivante :
|
||||||
| TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=uneGrannnndeClef"` |
|
| TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=uneGrannnndeClef"` |
|
||||||
| TXT | _dmarc | `"v=DMARC1; p=none"` |
|
| 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 ;
|
- 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 ;) ;
|
- 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
|
votre nom de domaine est `domain.tld`, vous devez obtenir le résultat suivant
|
||||||
en utilisant la commande `nslookup` :
|
en utilisant la commande `nslookup` :
|
||||||
|
|
||||||
```shell
|
```bash
|
||||||
$ nslookup 111.222.333.444
|
nslookup 111.222.333.444
|
||||||
444.333.222.111.in-addr.arpa name = domain.tld.
|
444.333.222.111.in-addr.arpa name = domain.tld.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -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 | mail._domainkey | `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"` |
|
||||||
| TXT | _dmarc | `"v=DMARC1; p=none"` |
|
| 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.
|
- 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 ;);
|
- 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`
|
domain is `domain.tld`, you should get following answer when using `nslookup`
|
||||||
command tool:
|
command tool:
|
||||||
|
|
||||||
```shell
|
```bash
|
||||||
$ nslookup 111.222.333.444
|
nslookup 111.222.333.444
|
||||||
444.333.222.111.in-addr.arpa name = domain.tld.
|
444.333.222.111.in-addr.arpa name = domain.tld.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -83,7 +83,7 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
|
||||||
| TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"` |
|
| TXT | mail._domainkey | `"v=DKIM1; k=rsa; p=someHuuuuuuugeKey"` |
|
||||||
| TXT | _dmarc | `"v=DMARC1; p=none"` |
|
| TXT | _dmarc | `"v=DMARC1; p=none"` |
|
||||||
|
|
||||||
#### Несколько замечаний по поводу этой таблицы
|
### Несколько замечаний по поводу этой таблицы
|
||||||
|
|
||||||
- Не все эти строки абсолютно необходимы. Для минимальной настройки вам понадобятся только записи, выделенные жирным шрифтом.
|
- Не все эти строки абсолютно необходимы. Для минимальной настройки вам понадобятся только записи, выделенные жирным шрифтом.
|
||||||
- Точка в конце `ваш.домен.tld.` важна ;);
|
- Точка в конце `ваш.домен.tld.` важна ;);
|
||||||
|
@ -106,8 +106,8 @@ _dmarc 3600 IN TXT "v=DMARC1; p=none"
|
||||||
-домен - `domain.tld`, вы должны получить следующий ответ при использовании
|
-домен - `domain.tld`, вы должны получить следующий ответ при использовании
|
||||||
командной строки `nslookup`:
|
командной строки `nslookup`:
|
||||||
|
|
||||||
```shell
|
```bash
|
||||||
$ nslookup 111.222.333.444
|
nslookup 111.222.333.444
|
||||||
444.333.222.111.in-addr.arpa name = domain.tld.
|
444.333.222.111.in-addr.arpa name = domain.tld.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
|
@ -7,31 +7,31 @@ routes:
|
||||||
default: '/installing_debian'
|
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
|
## 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
|
## 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
|
## Installing Debian
|
||||||
|
|
||||||
### Booting the installer
|
### 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
|
### Installing
|
||||||
|
|
||||||
In general, you can simply follow the instructions on screen and use the suggested defaults.
|
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!
|
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.
|
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
|
2. Reboot
|
||||||
3. Login as `root` with the long complex password you created earlier.
|
3. Login as `root` with the long complex password you created earlier.
|
||||||
4. Install curl by typing `apt install curl`
|
4. Install curl by typing `apt install curl`
|
||||||
5. Proceed to install Yunohost on Debian using these instructions: <https://yunohost.org/en/install/hardware:vps_debian>
|
5. Proceed to install YunoHost on Debian using these instructions: <https://yunohost.org/en/install/hardware:vps_debian>
|
||||||
- The installer will ask for permission to overwrite some configuration files. Select Yes.
|
- The installer will ask for permission to overwrite some configuration files. Select Yes.
|
||||||
|
|
|
@ -132,57 +132,55 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
|
||||||
|
|
||||||
[/div]
|
[/div]
|
||||||
|
|
||||||
|
|
||||||
{% if hardware != '' %}
|
{% if hardware != '' %}
|
||||||
|
|
||||||
{% if wsl %}
|
{% 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.
|
!! 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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
## [fa=list-alt /] Pre-requisites
|
## [fa=list-alt /] Pre-requisites
|
||||||
|
|
||||||
{% if regular %}
|
{% 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 %}
|
{% elseif rpi34 %}
|
||||||
* Ein Raspberry Pi 3 oder 4
|
- Ein Raspberry Pi 3 oder 4
|
||||||
{% elseif rpi012 %}
|
{% 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 %}
|
{% elseif internetcube %}
|
||||||
* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
|
- Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
|
||||||
* Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei
|
- Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei
|
||||||
{% elseif arm_sup %}
|
{% 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 %}
|
{% elseif arm_unsup %}
|
||||||
* Ein ARM Board mit mindestens 512MB RAM
|
- Ein ARM Board mit mindestens 512MB RAM
|
||||||
{% elseif vps_debian %}
|
{% elseif vps_debian %}
|
||||||
* Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) <small>(mit **kernel >= 3.12**)</small> vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum)
|
- Ein dedizierter oder Virtual Private Server mit Debian 11 (Bullseye) <small>(mit **kernel >= 3.12**)</small> vorinstalliert, 512MB RAM und 16GB Speicherkapazität (Minimum)
|
||||||
{% elseif vps_ynh %}
|
{% 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 %}
|
{% 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 %}
|
{% endif %}
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
* Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board;
|
- 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 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 %}
|
{% endif %}
|
||||||
{% if regular %}
|
{% 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 %}
|
{% endif %}
|
||||||
{% if wsl %}
|
{% if wsl %}
|
||||||
* Windows 10 und neuer
|
- Windows 10 und neuer
|
||||||
* Administrator Rechte
|
- Administrator Rechte
|
||||||
* Windows Subsystem for Linux, aus dem Optional Features Menü von Windows installiert
|
- 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.
|
- *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 %}
|
{% endif %}
|
||||||
{% if at_home %}
|
{% 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 %}
|
{% 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 %}
|
{% 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 %}
|
{% 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if virtualbox %}
|
{% if virtualbox %}
|
||||||
|
@ -190,7 +188,9 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% if wsl %}
|
{% if wsl %}
|
||||||
|
|
||||||
## Vorstellung
|
## 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.
|
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.
|
So kann z.B. Docker für Windows jetzt auf WSL bauen, anstatt auf Hyper-V.
|
||||||
|
|
||||||
|
@ -225,6 +225,7 @@ sudo apt update
|
||||||
sudo apt upgrade
|
sudo apt upgrade
|
||||||
sudo apt dist-upgrade
|
sudo apt dist-upgrade
|
||||||
```
|
```
|
||||||
|
|
||||||
## Verhindern, dass WSL an Konfigurationsdateien herumfeilt
|
## Verhindern, dass WSL an Konfigurationsdateien herumfeilt
|
||||||
|
|
||||||
Bearbeite `/etc/wsl.conf` und füge den folgenden Code darin ein:
|
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:
|
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:
|
1. Installation der dotNET Runtime:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In WSL
|
# In WSL
|
||||||
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
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):
|
2. Installation von [Genie](https://github.com/arkane-systems/genie):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In WSL
|
# In WSL
|
||||||
# Das repository hinzufügen
|
# Das repository hinzufügen
|
||||||
|
@ -292,7 +295,9 @@ Rufe `genie -s` immer während des Startes deiner Distro auf.
|
||||||
`wsl -d YunoHost -e genie -s`
|
`wsl -d YunoHost -e genie -s`
|
||||||
|
|
||||||
## Backup und Wiederherstellung der Distro
|
## Backup und Wiederherstellung der Distro
|
||||||
|
|
||||||
### Mache dein erstes Distro Backup
|
### Mache dein erstes Distro Backup
|
||||||
|
|
||||||
Wie zuvor gesagt, gibt es keine Rollback Möglichkeit. Lass uns deshal deine frische Distro exportieren. In PowerShell:
|
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 --unregister YunoHost
|
||||||
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
|
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
|
||||||
```
|
```
|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_ynh %}
|
{% if vps_ynh %}
|
||||||
|
|
||||||
## YunoHost VPS Provider
|
## YunoHost VPS Provider
|
||||||
|
|
||||||
Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen :
|
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]
|
[/div]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if at_home %}
|
{% if at_home %}
|
||||||
|
|
||||||
## [fa=download /] Lade das {{image_type}} Image herunter
|
## [fa=download /] Lade das {{image_type}} Image herunter
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
@ -413,17 +419,16 @@ $(document).ready(function () {
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if not virtualbox %}
|
{% if not virtualbox %}
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
##  Flash das {{image_type}} Image
|
##  Flash das {{image_type}} Image
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
##  Flash das YunoHost Image
|
##  Flash das YunoHost Image
|
||||||
|
|
||||||
{% endif %}
|
{% 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 %}
|
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...
|
# Ersetze /dev/mmcblk0 durch das richtige Device, wenn der Name deines Device anders ist...
|
||||||
dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
{% if regular %}
|
{% if regular %}
|
||||||
[ui-tab title="Eine CD/DVD brennen"]
|
[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.
|
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]
|
[/ui-tab]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
[/ui-tabs]
|
[/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**:
|
Gehe zu **Settings** > **Network**:
|
||||||
|
|
||||||
* Wähle `Bridged adapter`
|
- Wähle `Bridged adapter`
|
||||||
* Wähle den Namen deines Interface:
|
- Wähle den Namen deines Interface:
|
||||||
**wlan0**, wenn du kabellos verbunden bist, oder andernfalls **eth0**.
|
**wlan0**, wenn du kabellos verbunden bist, oder andernfalls **eth0**.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
## [fa=plug /] Das Board einschalten
|
## [fa=plug /] Das Board einschalten
|
||||||
|
|
||||||
* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
|
- 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.
|
- 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.
|
- 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.
|
- (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.
|
- Schalte das Board ein.
|
||||||
* Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert.
|
- 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.
|
- 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 %}
|
{% elseif virtualbox %}
|
||||||
|
|
||||||
## [fa=plug /] Die virtuelle Maschine hochfahren
|
## [fa=plug /] Die virtuelle Maschine hochfahren
|
||||||
|
|
||||||
Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
|
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.
|
! Wenn du an den Fehler "VT-x ist nicht erreichbar" gerätst, musst du wahrscheinlich Virtualisierung im BIOS deines Computers einschalten.
|
||||||
|
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
## [fa=plug /] Die Maschine von deinem USB Stick booten
|
## [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).
|
- 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:
|
- 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:
|
||||||
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` oder `<DEL>`.
|
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` oder `<DEL>`.
|
||||||
* 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if regular or virtualbox %}
|
{% if regular or virtualbox %}
|
||||||
|
|
||||||
## [fa=rocket /] Die grafische Installation starten
|
## [fa=rocket /] Die grafische Installation starten
|
||||||
|
|
||||||
Du solltest einen Bildschirm wie diesen sehen:
|
Du solltest einen Bildschirm wie diesen sehen:
|
||||||
|
@ -556,7 +557,8 @@ Das YunoHost-Projekt hat die klassische Installation so weit wie möglich verein
|
||||||
|
|
||||||
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.
|
1. Wähle `Expert graphical install` aus.
|
||||||
2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und möglicherweise deine Zeitzone 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.
|
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.
|
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
|
### Ü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").
|
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
|
### Über RAID
|
||||||
|
|
||||||
Denk daran, dass:
|
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.
|
- die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt).
|
||||||
* 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.
|
- 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-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
|
||||||
## [fa=bug /] Mit dem Board verbinden und das Image per Hotfix reparieren
|
## [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.
|
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.
|
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
|
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:
|
Führe dann die folgenden Befehle aus, um das Metronomproblem zu umgehen:
|
||||||
|
|
||||||
```
|
```
|
||||||
mv /usr/bin/metronome{,.bkp}
|
mv /usr/bin/metronome{,.bkp}
|
||||||
mv /usr/bin/metronomectl{,.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:
|
Und diesen hier, um das UpnPC-Problem zu umgehen:
|
||||||
|
|
||||||
```
|
```
|
||||||
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
|
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 %}
|
{% elseif arm_unsup %}
|
||||||
|
|
||||||
## [fa=terminal /] Verbindung zum Board
|
## [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.
|
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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_debian or arm_unsup %}
|
{% if vps_debian or arm_unsup %}
|
||||||
|
|
||||||
## [fa=rocket /] Das Installationsskript ausführen
|
## [fa=rocket /] Das Installationsskript ausführen
|
||||||
|
|
||||||
- Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh))
|
- Ö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 %}
|
{% 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).
|
!!! 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.
|
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
|
## [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.
|
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.
|
!!! 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-tabs position="top-left" active="0" theme="lite"]
|
||||||
[ui-tab title="(Empfohlen) Über die Weboberfläche"]
|
[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:
|
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]
|
||||||
[ui-tab title="In der Kommandozeile"]
|
[ui-tab title="In der Kommandozeile"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost diagnosis run
|
yunohost diagnosis run
|
||||||
yunohost diagnosis show --issues --human-readable
|
yunohost diagnosis show --issues --human-readable
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
@ -782,9 +793,11 @@ Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[ui-tab title="In der Kommandozeile"]
|
[ui-tab title="In der Kommandozeile"]
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
yunohost domain cert install
|
yunohost domain cert install
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
|
|
@ -126,56 +126,53 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
|
||||||
|
|
||||||
[/div]
|
[/div]
|
||||||
|
|
||||||
|
|
||||||
{% if hardware != '' %}
|
{% if hardware != '' %}
|
||||||
|
|
||||||
## [fa=list-alt /] Pré-requis
|
## [fa=list-alt /] Pré-requis
|
||||||
|
|
||||||
{% if regular %}
|
{% 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 %}
|
{% elseif rpi34 %}
|
||||||
* Un Raspberry Pi 3 ou 4 ;
|
- Un Raspberry Pi 3 ou 4 ;
|
||||||
{% elseif rpi012 %}
|
{% 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 %}
|
{% elseif internetcube %}
|
||||||
* Un Orange Pi PC+ ou une Olinuxino Lime 1 ou 2 ;
|
- 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 VPN avec une IP publique dédiée et un fichier `.cube` ;
|
||||||
{% elseif arm_sup %}
|
{% 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 %}
|
{% elseif arm_unsup %}
|
||||||
* Une carte ARM avec au moins 512Mo de RAM ;
|
- Une carte ARM avec au moins 512Mo de RAM ;
|
||||||
{% elseif vps_debian %}
|
{% elseif vps_debian %}
|
||||||
* Un serveur dédié ou virtuel avec Debian 11 (Bullseye) pré-installé <small>(avec un **kernel >= 3.12**)</small>, avec au moins 512Mo de RAM et 16Go de capacité de stockage ;
|
- Un serveur dédié ou virtuel avec Debian 11 (Bullseye) pré-installé <small>(avec un **kernel >= 3.12**)</small>, avec au moins 512Mo de RAM et 16Go de capacité de stockage ;
|
||||||
{% elseif vps_ynh %}
|
{% 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 %}
|
{% 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 %}
|
{% endif %}
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
* Une alimentation électrique (soit un adaptateur, soit un câble microUSB) pour alimenter la carte ;
|
- 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 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 %}
|
{% endif %}
|
||||||
{% if regular %}
|
{% 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 %}
|
{% endif %}
|
||||||
{% if at_home %}
|
{% 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 %}
|
{% 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 %}
|
{% 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 %}
|
{% 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if virtualbox %}
|
{% 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.
|
! 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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if vps_ynh %}
|
{% if vps_ynh %}
|
||||||
|
|
||||||
## Fournisseurs de VPS YunoHost
|
## Fournisseurs de VPS YunoHost
|
||||||
|
|
||||||
Ci-dessous une liste de fournisseurs de VPS supportant nativement 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]
|
[/div]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if at_home %}
|
{% if at_home %}
|
||||||
|
|
||||||
## [fa=download /] Télécharger l'image {{image_type}}
|
## [fa=download /] Télécharger l'image {{image_type}}
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
@ -278,17 +275,16 @@ $(document).ready(function () {
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if not virtualbox %}
|
{% if not virtualbox %}
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
##  Flasher l'image {{image_type}}
|
##  Flasher l'image {{image_type}}
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
##  Flasher l'image YunoHost
|
##  Flasher l'image YunoHost
|
||||||
|
|
||||||
{% endif %}
|
{% 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 %}
|
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"]
|
[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.
|
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]
|
||||||
[ui-tab title="Utiliser Ventoy"]
|
[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!
|
[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).
|
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.
|
- 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!
|
- 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]
|
[/ui-tab]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
[/ui-tabs]
|
[/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** :
|
Allez dans **Réglages** > **Réseau** :
|
||||||
|
|
||||||
* Sélectionnez `Accès par pont`
|
- Sélectionnez `Accès par pont`
|
||||||
* Choisissez votre interface selon son nom :
|
- Choisissez votre interface selon son nom :
|
||||||
**wlan0** si vous êtes connecté sans-fil, **eth0** ou **eno1** sinon.
|
**wlan0** si vous êtes connecté sans-fil, **eth0** ou **eno1** sinon.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
## [fa=plug /] Démarrer la carte
|
## [fa=plug /] Démarrer la carte
|
||||||
|
|
||||||
* Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre 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/).
|
- 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.
|
- 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.
|
- (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.
|
- Branchez l'alimentation.
|
||||||
* Laissez quelques minutes à votre serveur pour s'autoconfigurer durant le premier démarrage.
|
- 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.
|
- 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 %}
|
{% elseif virtualbox %}
|
||||||
|
|
||||||
## [fa=plug /] Lancer la machine virtuelle
|
## [fa=plug /] Lancer la machine virtuelle
|
||||||
|
|
||||||
Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
|
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.
|
! 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 %}
|
{% else %}
|
||||||
|
|
||||||
## [fa=plug /] Démarrer la machine sur la clé USB
|
## [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).
|
- 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) :
|
- 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) :
|
||||||
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` ou <Alt>.
|
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` ou <Alt>.
|
||||||
* 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 ».
|
- 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).
|
!!! 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if regular or virtualbox %}
|
{% if regular or virtualbox %}
|
||||||
## [fa=rocket /] Lancer l’installation graphique
|
|
||||||
|
|
||||||
|
## [fa=rocket /] Lancer l’installation graphique
|
||||||
|
|
||||||
Votre écran devrait ressembler à la capture ci-dessous :
|
Votre écran devrait ressembler à la capture ci-dessous :
|
||||||
|
|
||||||
|
@ -434,7 +426,8 @@ Le projet YunoHost a simplifié au maximum l'installation classique afin d'évit
|
||||||
|
|
||||||
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`
|
1. Sélectionnez `Expert graphical install`
|
||||||
2. Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone.
|
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.
|
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).
|
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
|
### 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").
|
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
|
### A propos du RAID
|
||||||
|
|
||||||
Ne perdez pas de vue que:
|
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 disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
|
||||||
* 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
|
- 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-tab]
|
||||||
[/ui-tabs]
|
[/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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
|
||||||
## [fa=bug /] Se connecter à la carte et corriger l'image
|
## [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).
|
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.
|
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`:
|
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
|
ssh root@yunohost.local
|
||||||
```
|
```
|
||||||
|
|
||||||
(utilisez `yunohost-2.local`, etc. s'il y a plusieurs serveurs YunoHost sur le réseau)
|
(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 :
|
Ensuite, lancez les commandes suivantes pour contourner le dysfonctionnement de Metronome :
|
||||||
|
|
||||||
```
|
```
|
||||||
mv /usr/bin/metronome{,.bkp}
|
mv /usr/bin/metronome{,.bkp}
|
||||||
mv /usr/bin/metronomectl{,.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 :
|
Et celle-ci pour contourner celui de upnpc :
|
||||||
|
|
||||||
```
|
```
|
||||||
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
|
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 :/
|
! Cette dernière commande nécessite d'être lancée après chaque mise à jour de YunoHost :/
|
||||||
|
|
||||||
{% elseif arm_unsup %}
|
{% elseif arm_unsup %}
|
||||||
|
|
||||||
## [fa=terminal /] Se connecter à la carte
|
## [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`.
|
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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_debian or arm_unsup %}
|
{% if vps_debian or arm_unsup %}
|
||||||
|
|
||||||
## [fa=rocket /] Lancer le script d'installation
|
## [fa=rocket /] Lancer le script d'installation
|
||||||
|
|
||||||
- Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh))
|
- 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
|
```bash
|
||||||
curl https://install.yunohost.org | 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`.
|
!!! 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`
|
!!! 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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
## [fa=cog /] Lancer la configuration initiale
|
## [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).
|
!!! 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,9 +578,9 @@ 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.
|
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).
|
!!! 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).
|
||||||
|
|
||||||
|
@ -612,10 +614,12 @@ Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagno
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[ui-tab title="À partir de la ligne de commande"]
|
[ui-tab title="À partir de la ligne de commande"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost diagnosis run
|
yunohost diagnosis run
|
||||||
yunohost diagnosis show --issues --human-readable
|
yunohost diagnosis show --issues --human-readable
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/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]
|
||||||
[ui-tab title="À partir de la ligne de commande"]
|
[ui-tab title="À partir de la ligne de commande"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost domain cert install
|
yunohost domain cert install
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
|
|
@ -132,57 +132,55 @@ Select the hardware on which you want install YunoHost :
|
||||||
|
|
||||||
[/div]
|
[/div]
|
||||||
|
|
||||||
|
|
||||||
{% if hardware != '' %}
|
{% if hardware != '' %}
|
||||||
|
|
||||||
{% if wsl %}
|
{% 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.
|
!! 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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
## [fa=list-alt /] Pre-requisites
|
## [fa=list-alt /] Pre-requisites
|
||||||
|
|
||||||
{% if regular %}
|
{% 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 %}
|
{% elseif rpi34 %}
|
||||||
* A Raspberry Pi 3 or 4
|
- A Raspberry Pi 3 or 4
|
||||||
{% elseif rpi012 %}
|
{% 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 %}
|
{% elseif internetcube %}
|
||||||
* An Orange Pi PC+ or an Olinuxino Lime 1 or 2
|
- An Orange Pi PC+ or an Olinuxino Lime 1 or 2
|
||||||
* A VPN with a dedicated public IP and a `.cube` file
|
- A VPN with a dedicated public IP and a `.cube` file
|
||||||
{% elseif arm_sup %}
|
{% 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 %}
|
{% elseif arm_unsup %}
|
||||||
* An ARM board with at least 512MB RAM
|
- An ARM board with at least 512MB RAM
|
||||||
{% elseif vps_debian %}
|
{% elseif vps_debian %}
|
||||||
* A dedicated or virtual private server with Debian 11 (Bullseye) <small>(with **kernel >= 3.12**)</small> preinstalled, 512MB RAM and 16GB capacity (at least)
|
- A dedicated or virtual private server with Debian 11 (Bullseye) <small>(with **kernel >= 3.12**)</small> preinstalled, 512MB RAM and 16GB capacity (at least)
|
||||||
{% elseif vps_ynh %}
|
{% 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 %}
|
{% 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 %}
|
{% endif %}
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
* A power supply (either an adapter or a MicroUSB cable) for your board;
|
- 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 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 %}
|
{% endif %}
|
||||||
{% if regular %}
|
{% 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 %}
|
{% endif %}
|
||||||
{% if wsl %}
|
{% if wsl %}
|
||||||
* Windows 10 and above
|
- Windows 10 and above
|
||||||
* Administration rights
|
- Administration rights
|
||||||
* Windows Subsystem for Linux, installed from the Optional Features menu of Windows
|
- 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.
|
- *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 %}
|
{% endif %}
|
||||||
{% if at_home %}
|
{% 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 %}
|
{% 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 %}
|
{% 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 %}
|
{% 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if virtualbox %}
|
{% if virtualbox %}
|
||||||
|
@ -190,7 +188,9 @@ Select the hardware on which you want install YunoHost :
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% if wsl %}
|
{% if wsl %}
|
||||||
|
|
||||||
## Introduction
|
## 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.
|
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.
|
Docker for Windows can now rely on WSL instead of Hyper-V, for example.
|
||||||
|
|
||||||
|
@ -225,6 +225,7 @@ sudo apt update
|
||||||
sudo apt upgrade
|
sudo apt upgrade
|
||||||
sudo apt dist-upgrade
|
sudo apt dist-upgrade
|
||||||
```
|
```
|
||||||
|
|
||||||
## Prevent WSL from tweaking configuration files
|
## Prevent WSL from tweaking configuration files
|
||||||
|
|
||||||
Edit `/etc/wsl.conf` and put the following code in it:
|
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:
|
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:
|
1. Install dotNET runtime:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In WSL
|
# In WSL
|
||||||
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
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):
|
2. Install [Genie](https://github.com/arkane-systems/genie):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In WSL
|
# In WSL
|
||||||
# Add their repository
|
# Add their repository
|
||||||
|
@ -292,7 +295,9 @@ Always call `genie -s` while starting your distro.
|
||||||
`wsl -d YunoHost -e genie -s`
|
`wsl -d YunoHost -e genie -s`
|
||||||
|
|
||||||
## Backup and restore the distro
|
## Backup and restore the distro
|
||||||
|
|
||||||
### Make your first distro backup
|
### Make your first distro backup
|
||||||
|
|
||||||
As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
|
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 --unregister YunoHost
|
||||||
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
|
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
|
||||||
```
|
```
|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_ynh %}
|
{% if vps_ynh %}
|
||||||
|
|
||||||
## YunoHost VPS providers
|
## YunoHost VPS providers
|
||||||
|
|
||||||
Here are some VPS providers supporting YunoHost natively :
|
Here are some VPS providers supporting YunoHost natively :
|
||||||
|
@ -329,8 +335,8 @@ Here are some VPS providers supporting YunoHost natively :
|
||||||
[/div]
|
[/div]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if at_home %}
|
{% if at_home %}
|
||||||
|
|
||||||
## [fa=download /] Download the {{image_type}} image
|
## [fa=download /] Download the {{image_type}} image
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
@ -413,17 +419,16 @@ $(document).ready(function () {
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if not virtualbox %}
|
{% if not virtualbox %}
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
##  Flash the {{image_type}} image
|
##  Flash the {{image_type}} image
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
##  Flash the YunoHost image
|
##  Flash the YunoHost image
|
||||||
|
|
||||||
{% endif %}
|
{% 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 %}
|
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...
|
# Replace /dev/mmcblk0 if the name of your device is different...
|
||||||
dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
{% if regular %}
|
{% if regular %}
|
||||||
[ui-tab title="Burning a CD/DVD"]
|
[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.
|
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]
|
||||||
[ui-tab title="Using Ventoy"]
|
[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!
|
[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).
|
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.
|
- 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!
|
- 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]
|
[/ui-tab]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
[/ui-tabs]
|
[/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**:
|
Go to **Settings** > **Network**:
|
||||||
|
|
||||||
* Select `Bridged adapter`
|
- Select `Bridged adapter`
|
||||||
* Select your interface's name:
|
- Select your interface's name:
|
||||||
**wlan0** if you are connected wirelessly, or **eth0** otherwise.
|
**wlan0** if you are connected wirelessly, or **eth0** otherwise.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
## [fa=plug /] Power up the board
|
## [fa=plug /] Power up the board
|
||||||
|
|
||||||
* Plug the ethernet cable (one side on your main router, the other on your 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/).
|
- 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
|
- 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.
|
- (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
|
- Power up the board
|
||||||
* Wait a couple minutes while the board autoconfigure itself during the first boot
|
- 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.
|
- Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
|
||||||
|
|
||||||
{% elseif virtualbox %}
|
{% elseif virtualbox %}
|
||||||
|
|
||||||
## [fa=plug /] Boot up the virtual machine
|
## [fa=plug /] Boot up the virtual machine
|
||||||
|
|
||||||
Start the virtual machine after selecting the YunoHost image.
|
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.
|
! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
|
||||||
|
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
## [fa=plug /] Boot the machine on your USB stick
|
## [fa=plug /] Boot the machine on your USB stick
|
||||||
|
|
||||||
* Plug the ethernet cable (one side on your main router, the other on your server).
|
- 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:
|
- 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:
|
||||||
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` or `<Alt>`.
|
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` or `<Alt>`.
|
||||||
* 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if regular or virtualbox %}
|
{% if regular or virtualbox %}
|
||||||
|
|
||||||
## [fa=rocket /] Launch the graphical install
|
## [fa=rocket /] Launch the graphical install
|
||||||
|
|
||||||
You should see a screen like this:
|
You should see a screen like this:
|
||||||
|
@ -569,7 +571,8 @@ The YunoHost project simplified the classic installation as much as possible in
|
||||||
|
|
||||||
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`.
|
1. Select `Expert graphical install`.
|
||||||
2. Select your language, location, keyboard layout and possibly your timezone.
|
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.
|
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).
|
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
|
### 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").
|
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
|
### About RAID
|
||||||
|
|
||||||
Keep in mind that:
|
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
|
- the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
|
||||||
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
|
- 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-tab]
|
||||||
[/ui-tabs]
|
[/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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
|
||||||
## [fa=bug /] Connect to the board and hotfix the image
|
## [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).
|
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.
|
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`:
|
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
|
ssh root@yunohost.local
|
||||||
```
|
```
|
||||||
|
|
||||||
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
|
(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:
|
Then run the following commands to work around the metronome issue:
|
||||||
|
|
||||||
```
|
```
|
||||||
mv /usr/bin/metronome{,.bkp}
|
mv /usr/bin/metronome{,.bkp}
|
||||||
mv /usr/bin/metronomectl{,.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:
|
And this one to work around the upnpc issue:
|
||||||
|
|
||||||
```
|
```
|
||||||
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
|
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 %}
|
{% elseif arm_unsup %}
|
||||||
|
|
||||||
## [fa=terminal /] Connect to the board
|
## [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`.
|
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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_debian or arm_unsup %}
|
{% if vps_debian or arm_unsup %}
|
||||||
|
|
||||||
## [fa=rocket /] Run the install script
|
## [fa=rocket /] Run the install script
|
||||||
|
|
||||||
- Open a command line prompt on your server (either directly or [through SSH](/ssh))
|
- 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 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).
|
!!! 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.
|
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
|
## [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.
|
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]
|
||||||
[ui-tab title="From the command line"]
|
[ui-tab title="From the command line"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost diagnosis run
|
yunohost diagnosis run
|
||||||
yunohost diagnosis show --issues --human-readable
|
yunohost diagnosis show --issues --human-readable
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
@ -796,9 +809,11 @@ Go in Domains > Click on your domain > SSL Certificate
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[ui-tab title="From the command line"]
|
[ui-tab title="From the command line"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost domain cert install
|
yunohost domain cert install
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
|
|
@ -132,57 +132,56 @@ routes:
|
||||||
|
|
||||||
[/div]
|
[/div]
|
||||||
|
|
||||||
|
|
||||||
{% if hardware != '' %}
|
{% if hardware != '' %}
|
||||||
|
|
||||||
{% if wsl %}
|
{% if wsl %}
|
||||||
!! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет.
|
!! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет.
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
## [fa=list-alt /] Предварительные условия
|
## [fa=list-alt /] Предварительные условия
|
||||||
|
|
||||||
{% if regular %}
|
{% if regular %}
|
||||||
* x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
|
|
||||||
|
- x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
|
||||||
{% elseif rpi34 %}
|
{% elseif rpi34 %}
|
||||||
* Raspberry Pi 3 or 4
|
- Raspberry Pi 3 or 4
|
||||||
{% elseif rpi012 %}
|
{% elseif rpi012 %}
|
||||||
* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ
|
- Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ
|
||||||
{% elseif internetcube %}
|
{% elseif internetcube %}
|
||||||
* Orange Pi PC+ или Olinuxino Lime 1 или 2
|
- Orange Pi PC+ или Olinuxino Lime 1 или 2
|
||||||
* VPN с выделенным общедоступным IP-адресом и файлом `.cube`
|
- VPN с выделенным общедоступным IP-адресом и файлом `.cube`
|
||||||
{% elseif arm_sup %}
|
{% elseif arm_sup %}
|
||||||
* Orange Pi PC+ или Olinuxino Lime 1 или 2
|
- Orange Pi PC+ или Olinuxino Lime 1 или 2
|
||||||
{% elseif arm_unsup %}
|
{% elseif arm_unsup %}
|
||||||
* Плата ARM с объемом оперативной памяти не менее 512 МБ
|
- Плата ARM с объемом оперативной памяти не менее 512 МБ
|
||||||
{% elseif vps_debian %}
|
{% elseif vps_debian %}
|
||||||
* Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) <small>(с **kernel >= 3.12**)</small> предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее)
|
- Выделенный или виртуальный частный сервер с Debian 11 (Bullseye) <small>(с **kernel >= 3.12**)</small> предустановленный, 512 МБ оперативной памяти и емкость 16 ГБ (не менее)
|
||||||
{% elseif vps_ynh %}
|
{% elseif vps_ynh %}
|
||||||
* Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ
|
- Выделенный или виртуальный частный сервер с предустановленным YunoHost, 512 МБ оперативной памяти и емкостью не менее 16 ГБ
|
||||||
{% elseif virtualbox %}
|
{% elseif virtualbox %}
|
||||||
* Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум).
|
- Компьютер x86 с [установленным VirtualBox](https://www.virtualbox.org/wiki/Downloads) и достаточный объем оперативной памяти, чтобы иметь возможность запускать небольшую виртуальную машину с 1024 МБ оперативной памяти и емкостью 8 ГБ (как минимум).
|
||||||
{% endif %}
|
{% endif %}
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
*Источник питания (либо адаптер, либо кабель microUSB) для вашей платы;
|
*Источник питания (либо адаптер, либо кабель 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 %}
|
{% endif %}
|
||||||
{% if regular %}
|
{% if regular %}
|
||||||
* USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск
|
- USB-накопитель емкостью не менее 1 ГБ или стандартный чистый компакт-диск
|
||||||
{% endif %}
|
{% endif %}
|
||||||
{% if wsl %}
|
{% if wsl %}
|
||||||
* Windows 10 и выше
|
- Windows 10 и выше
|
||||||
* Права администратора
|
- Права администратора
|
||||||
* Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows*
|
- Подсистема Windows для Linux, устанавливаемая из *Включение или отключение компонентов Windows*
|
||||||
* *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL.
|
- *Рекомендуется:* Приложение Windows Terminal (предварительный просмотр), установленное из магазина Microsoft Store. Намного лучше, чем стандартный терминал, поскольку он предлагает быстрые пути к дистрибутивам WSL.
|
||||||
{% endif %}
|
{% endif %}
|
||||||
{% if at_home %}
|
{% if at_home %}
|
||||||
* [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания
|
- [хороший Интернет-провайдер](/isp), предпочтительно с хорошей и неограниченной восходящей полосой пропускания
|
||||||
{% if not virtualbox %}
|
{% 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 %}
|
{% endif %}
|
||||||
* Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу.
|
- Компьютер, чтобы прочитать это руководство, прошейте изображение и получите доступ к вашему серверу.
|
||||||
{% else %}
|
{% else %}
|
||||||
* Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу.
|
- Компьютер или смартфон, чтобы прочитать это руководство и получить доступ к вашему серверу.
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% if virtualbox %}
|
{% if virtualbox %}
|
||||||
|
@ -190,7 +189,9 @@ routes:
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% if wsl %}
|
{% 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.
|
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.
|
Docker for Windows can now rely on WSL instead of Hyper-V, for example.
|
||||||
|
|
||||||
|
@ -225,6 +226,7 @@ sudo apt update
|
||||||
sudo apt upgrade
|
sudo apt upgrade
|
||||||
sudo apt dist-upgrade
|
sudo apt dist-upgrade
|
||||||
```
|
```
|
||||||
|
|
||||||
## Prevent WSL from tweaking configuration files
|
## Prevent WSL from tweaking configuration files
|
||||||
|
|
||||||
Edit `/etc/wsl.conf` and put the following code in it:
|
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:
|
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:
|
1. Install dotNET runtime:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In WSL
|
# In WSL
|
||||||
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
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):
|
2. Install [Genie](https://github.com/arkane-systems/genie):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In WSL
|
# In WSL
|
||||||
# Add their repository
|
# Add their repository
|
||||||
|
@ -292,7 +296,9 @@ Always call `genie -s` while starting your distro.
|
||||||
`wsl -d YunoHost -e genie -s`
|
`wsl -d YunoHost -e genie -s`
|
||||||
|
|
||||||
## Backup and restore the distro
|
## Backup and restore the distro
|
||||||
|
|
||||||
### Make your first distro backup
|
### Make your first distro backup
|
||||||
|
|
||||||
As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell:
|
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 --unregister YunoHost
|
||||||
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
|
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
|
||||||
```
|
```
|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_ynh %}
|
{% if vps_ynh %}
|
||||||
|
|
||||||
## YunoHost VPS providers
|
## YunoHost VPS providers
|
||||||
|
|
||||||
Here are some VPS providers supporting YunoHost natively :
|
Here are some VPS providers supporting YunoHost natively :
|
||||||
|
@ -329,8 +336,8 @@ Here are some VPS providers supporting YunoHost natively :
|
||||||
[/div]
|
[/div]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if at_home %}
|
{% if at_home %}
|
||||||
|
|
||||||
## [fa=download /] Download the {{image_type}} image
|
## [fa=download /] Download the {{image_type}} image
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
@ -413,17 +420,16 @@ $(document).ready(function () {
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if not virtualbox %}
|
{% if not virtualbox %}
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
##  Flash the {{image_type}} image
|
##  Flash the {{image_type}} image
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
##  Flash the YunoHost image
|
##  Flash the YunoHost image
|
||||||
|
|
||||||
{% endif %}
|
{% 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 %}
|
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...
|
# Replace /dev/mmcblk0 if the name of your device is different...
|
||||||
dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
dd if=/path/to/yunohost.img of=/dev/mmcblk0
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
{% if regular %}
|
{% if regular %}
|
||||||
[ui-tab title="Burning a CD/DVD"]
|
[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.
|
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]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
[/ui-tabs]
|
[/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**:
|
Go to **Settings** > **Network**:
|
||||||
|
|
||||||
* Select `Bridged adapter`
|
- Select `Bridged adapter`
|
||||||
* Select your interface's name:
|
- Select your interface's name:
|
||||||
**wlan0** if you are connected wirelessly, or **eth0** otherwise.
|
**wlan0** if you are connected wirelessly, or **eth0** otherwise.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
{% if arm %}
|
{% if arm %}
|
||||||
|
|
||||||
## [fa=plug /] Power up the board
|
## [fa=plug /] Power up the board
|
||||||
|
|
||||||
* Plug the ethernet cable (one side on your main router, the other on your board).
|
- Plug the ethernet cable (one side on your main router, the other on your board).
|
||||||
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
|
- For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
|
||||||
* Plug the SD card in your board
|
- 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.
|
- (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
|
- Power up the board
|
||||||
* Wait a couple minutes while the board autoconfigure itself during the first boot
|
- 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.
|
- Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
|
||||||
|
|
||||||
{% elseif virtualbox %}
|
{% elseif virtualbox %}
|
||||||
|
|
||||||
## [fa=plug /] Boot up the virtual machine
|
## [fa=plug /] Boot up the virtual machine
|
||||||
|
|
||||||
Start the virtual machine after selecting the YunoHost image.
|
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.
|
! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
|
||||||
|
|
||||||
|
|
||||||
{% else %}
|
{% else %}
|
||||||
|
|
||||||
## [fa=plug /] Boot the machine on your USB stick
|
## [fa=plug /] Boot the machine on your USB stick
|
||||||
|
|
||||||
* Plug the ethernet cable (one side on your main router, the other on your server).
|
- 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):
|
- 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):
|
||||||
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` or `<DEL>`.
|
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` or `<DEL>`.
|
||||||
* 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 %}
|
{% endif %}
|
||||||
|
|
||||||
{% if regular or virtualbox %}
|
{% if regular or virtualbox %}
|
||||||
|
|
||||||
## [fa=rocket /] Launch the graphical install
|
## [fa=rocket /] Launch the graphical install
|
||||||
|
|
||||||
You should see a screen like this:
|
You should see a screen like this:
|
||||||
|
@ -556,7 +558,8 @@ The YunoHost project simplified the classic installation as much as possible in
|
||||||
|
|
||||||
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`.
|
1. Select `Expert graphical install`.
|
||||||
2. Select your language, location, keyboard layout and possibly your timezone.
|
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.
|
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).
|
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
|
### 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").
|
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
|
### About RAID
|
||||||
|
|
||||||
Keep in mind that:
|
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
|
- the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
|
||||||
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
|
- 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-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if rpi012 %}
|
{% if rpi012 %}
|
||||||
|
|
||||||
## [fa=bug /] Connect to the board and hotfix the image
|
## [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).
|
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.
|
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`:
|
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
|
ssh root@yunohost.local
|
||||||
```
|
```
|
||||||
|
|
||||||
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
|
(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:
|
Then run the following commands to work around the metronome issue:
|
||||||
|
|
||||||
```
|
```
|
||||||
mv /usr/bin/metronome{,.bkp}
|
mv /usr/bin/metronome{,.bkp}
|
||||||
mv /usr/bin/metronomectl{,.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:
|
And this one to work around the upnpc issue:
|
||||||
|
|
||||||
```
|
```
|
||||||
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
|
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 %}
|
{% elseif arm_unsup %}
|
||||||
|
|
||||||
## [fa=terminal /] Connect to the board
|
## [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`.
|
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 %}
|
{% endif %}
|
||||||
|
|
||||||
|
|
||||||
{% if vps_debian or arm_unsup %}
|
{% if vps_debian or arm_unsup %}
|
||||||
|
|
||||||
## [fa=rocket /] Run the install script
|
## [fa=rocket /] Run the install script
|
||||||
|
|
||||||
- Open a command line prompt on your server (either directly or [through SSH](/ssh))
|
- 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 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).
|
!!! 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.
|
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
|
## [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.
|
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]
|
||||||
[ui-tab title="From the command line"]
|
[ui-tab title="From the command line"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost diagnosis run
|
yunohost diagnosis run
|
||||||
yunohost diagnosis show --issues --human-readable
|
yunohost diagnosis show --issues --human-readable
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
@ -781,9 +794,11 @@ Go in Domains > Click on your domain > SSL Certificate
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[ui-tab title="From the command line"]
|
[ui-tab title="From the command line"]
|
||||||
|
|
||||||
```
|
```
|
||||||
yunohost domain cert install
|
yunohost domain cert install
|
||||||
```
|
```
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
[/ui-tabs]
|
[/ui-tabs]
|
||||||
|
|
||||||
|
|
|
@ -17,7 +17,7 @@ page-toc:
|
||||||
|
|
||||||
## Während der YunoHost Installation
|
## 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.
|
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;
|
- 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`.
|
- 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:
|
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.
|
! 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.
|
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.
|
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!
|
!!! 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:
|
YunoHost-Befehle haben normalerweise diese Art von Struktur:
|
||||||
|
|
||||||
```test
|
```text
|
||||||
yunohost app install wordpress --label Webmail
|
yunohost app install wordpress --label Webmail
|
||||||
^ ^ ^ ^
|
^ ^ ^ ^
|
||||||
| | | |
|
| | | |
|
||||||
|
|
|
@ -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
|
## 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.
|
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 ;
|
- 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`.
|
- 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 :
|
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.
|
! 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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -17,7 +17,7 @@ page-toc:
|
||||||
|
|
||||||
## Durante l'installazione di YunoHost
|
## 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.
|
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;
|
- 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`.
|
- 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:
|
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.
|
! 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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -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,
|
- `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.
|
- `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.
|
Vous ne pouvez pas changer le contenu de ces groupes, seulement les permissions qui leur sont accordées.
|
||||||
|
|
||||||
|
|
|
@ -14,7 +14,7 @@ Und zwar, werden die Benutzer eine solche Warnung auf dem Bildschirm sehen:
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
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.
|
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**.
|
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**.
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/domains'
|
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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -21,7 +21,7 @@ Domains can be managed in the 'Domain' section of the webadmin, or through the `
|
||||||
## 3 types of domains
|
## 3 types of domains
|
||||||
|
|
||||||
[ui-tabs position="top-left" active="0" theme="lite"]
|
[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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -111,8 +111,8 @@ Da questa pagina è anche possibile eliminare l'applicazione.
|
||||||
|
|
||||||
Dalla riga di comando è possibile cambiare:
|
Dalla riga di comando è possibile cambiare:
|
||||||
|
|
||||||
* l'etichetta dell'applicazione nel sistema SSO: `yunohost app change-label <app> <new_label>`
|
- l'etichetta dell'applicazione nel sistema SSO: `yunohost app change-label <app> <new_label>`
|
||||||
* l'url di connessione: `yunohost app change-url <app> [-d <DOMAIN>] [-p <PATH>]`
|
- l'url di connessione: `yunohost app change-url <app> [-d <DOMAIN>] [-p <PATH>]`
|
||||||
|
|
||||||
È anche possibile eliminare l'applicazione: `yunohost app remove <app>`
|
È anche possibile eliminare l'applicazione: `yunohost app remove <app>`
|
||||||
|
|
||||||
|
|
|
@ -107,8 +107,8 @@ You can also delete the application from this page.
|
||||||
|
|
||||||
From the command line, you can change:
|
From the command line, you can change:
|
||||||
|
|
||||||
* the app's label in the SSO: `yunohost app change-label <app> <new_label>`
|
- the app's label in the SSO: `yunohost app change-label <app> <new_label>`
|
||||||
* the app's url: `yunohost app change-url app [-d <DOMAIN>] [-p <PATH>]`
|
- the app's url: `yunohost app change-url app [-d <DOMAIN>] [-p <PATH>]`
|
||||||
|
|
||||||
You can also delete the app: `yunohost app remove <app>`
|
You can also delete the app: `yunohost app remove <app>`
|
||||||
|
|
||||||
|
|
|
@ -96,7 +96,7 @@ yunohost app upgrade --force APP_NAME
|
||||||
|
|
||||||
### Can't run the migration due to `libc6-dev : Breaks: libgcc-8-dev issue`
|
### 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.
|
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
|
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
|
||||||
|
|
|
@ -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
|
### 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
|
### Vérifiez que les applications fonctionnent
|
||||||
|
|
||||||
|
|
|
@ -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
|
### 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
|
### Check that your applications are working
|
||||||
|
|
||||||
|
|
|
@ -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 :
|
Voici quelques exemples en ligne de commande correspondants :
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
# Aller chercher les mises à jour disponibles
|
# Aller chercher les mises à jour disponibles
|
||||||
yunohost tools update
|
yunohost tools update
|
||||||
|
|
||||||
|
|
|
@ -19,7 +19,7 @@ Click on green upgrade buttons to upgrade the system and applications.
|
||||||
|
|
||||||
Here are some example of corresponding command lines:
|
Here are some example of corresponding command lines:
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
# Fetch available updates
|
# Fetch available updates
|
||||||
yunohost tools update
|
yunohost tools update
|
||||||
|
|
||||||
|
|
|
@ -22,7 +22,7 @@ con BorgBackup potrete:
|
||||||
- definire i tipi di dati da copiare e la frequenza di backup
|
- definire i tipi di dati da copiare e la frequenza di backup
|
||||||
- ricevere una mail di allerta in caso di fallimento del 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
|
Il futuro metodo di backup integrato in YunoHost sarà basato su BorgBackup
|
||||||
|
|
||||||
|
|
|
@ -12,7 +12,7 @@ page-toc:
|
||||||
|
|
||||||
!! Images are missing on this page
|
!! 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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -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:
|
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
|
- 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 (><)
|
- 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
|
- 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
|
- 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
|
- 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
|
- 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).
|
!!! 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).
|
||||||
|
|
|
@ -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.
|
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
|
- 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 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
|
- 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
|
- 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
|
- anche i controller RAID o i connettori possono guastarsi o dare errori
|
||||||
* più complessa è la nostra catena, maggiori sono le possibilità di un guasto
|
- 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).
|
!!! 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).
|
||||||
|
|
|
@ -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:
|
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
|
- 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 (><)
|
- 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
|
- 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
|
- 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 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 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).
|
!!! 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).
|
||||||
|
|
|
@ -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:
|
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
|
```bash
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
|
@ -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.
|
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
|
```bash
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
|
@ -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:
|
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
|
```bash
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
|
@ -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.
|
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
|
### Adding a nohost.me, noho.st or ynh.fr domain after the post-installation
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/dns_dynamicip'
|
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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/dns_dynamicip'
|
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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/dns_dynamicip'
|
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
|
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
|
||||||
|
|
||||||
|
|
|
@ -55,12 +55,12 @@ Installez le programme et lancez *Filezilla*.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
----
|
---
|
||||||
|
|
||||||
Sources
|
Sources
|
||||||
|
|
||||||
* [Documentation officielle](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(fr))
|
- [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/)
|
- [Tutoriel général à Filezilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
|
||||||
|
|
||||||
## Alternatives à Filezilla
|
## 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 :
|
Nautilus de Gnome3 et Dolphin de KDE intègrent de base des fonctionnalités similaires à FileZilla :
|
||||||
|
|
||||||
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
- <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
||||||
* <https://docs.kde.org/stable5/en/dolphin/dolphin/location-bar.html#location-bar-editable-kioslaves>
|
- <https://docs.kde.org/stable5/en/dolphin/dolphin/location-bar.html#location-bar-editable-kioslaves>
|
||||||
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
- <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
||||||
|
|
||||||
### Sous Windows
|
### 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
|
### Sous macOS
|
||||||
|
|
||||||
* [Cyberduck](https://cyberduck.io/) logiciel libre pour macOS
|
- [Cyberduck](https://cyberduck.io/) logiciel libre pour macOS
|
||||||
|
|
|
@ -55,7 +55,7 @@ Installate e lanciate *FileZilla*
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
----
|
---
|
||||||
|
|
||||||
Link a fonti esterne:
|
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:
|
Nautilus di Gnome3 integra delle funzionalità simili a FileZilla:
|
||||||
|
|
||||||
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
- <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
||||||
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
- <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
||||||
|
|
||||||
### Windows
|
### Windows
|
||||||
|
|
||||||
|
|
|
@ -55,12 +55,12 @@ Install the program and run *Filezilla*.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
----
|
---
|
||||||
|
|
||||||
Sources
|
Sources
|
||||||
|
|
||||||
* [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en))
|
- [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/)
|
- [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
|
||||||
|
|
||||||
## Alternatives to Filezilla
|
## 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.
|
Nautilus from Gnome3 and Dolphin from KDE have features similar to FileZilla, out of the box.
|
||||||
|
|
||||||
* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
- <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
|
||||||
* <https://docs.kde.org/stable5/en/dolphin/dolphin/location-bar.html#location-bar-editable-kioslaves>
|
- <https://docs.kde.org/stable5/en/dolphin/dolphin/location-bar.html#location-bar-editable-kioslaves>
|
||||||
* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
- <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
|
||||||
|
|
||||||
### Windows
|
### Windows
|
||||||
|
|
||||||
* [WinSCP](https://winscp.net/) is also a nice candidate for Windows
|
- [WinSCP](https://winscp.net/) is also a nice candidate for Windows
|
||||||
|
|
||||||
### macOS
|
### macOS
|
||||||
|
|
||||||
* [Cyberduck](https://cyberduck.io/) is a free software available on macOS
|
- [Cyberduck](https://cyberduck.io/) is a free software available on macOS
|
||||||
|
|
|
@ -23,15 +23,15 @@ Ci-dessous, vous trouverez des explications pour parvenir à déplacer vos donn
|
||||||
|
|
||||||
## [fa=list-alt /] Pré-requis
|
## [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
|
## 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` | 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.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 |
|
| `/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/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 |
|
| `/var/lib/postgresql` | Base de données utilisées par les applications | A laisser idéalement sur le SSD pour des raisons de performances |
|
||||||
|
|
|
@ -23,15 +23,15 @@ Troverete qui le istruzioni per riuscire a spostare i vostri dati su un disco es
|
||||||
|
|
||||||
## [fa=list-alt /] Prerequisiti
|
## [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
|
## 1. Identificare le cartelle da spostare
|
||||||
|
|
||||||
|
|
|
@ -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
|
## [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
|
## 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` | 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.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 |
|
| `/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/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 |
|
| `/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)
|
(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
|
### 5.1 Creating subfolders on the disk
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/torhiddenservice'
|
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 <https://www.torproject.org/docs/tor-hidden-service.html.en> (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 <https://www.torproject.org/docs/tor-hidden-service.html.en> (anglais)
|
||||||
|
|
||||||
### Installer Tor
|
### Installer Tor
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/torhiddenservice'
|
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 <https://www.torproject.org/docs/tor-hidden-service.html>
|
! 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 <https://www.torproject.org/docs/tor-hidden-service.html>
|
||||||
|
|
||||||
### Installare Tor
|
### Installare Tor
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/torhiddenservice'
|
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 <https://www.torproject.org/docs/tor-hidden-service.html.en>
|
! 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 <https://www.torproject.org/docs/tor-hidden-service.html.en>
|
||||||
|
|
||||||
### Installing Tor
|
### Installing Tor
|
||||||
|
|
||||||
|
|
|
@ -11,8 +11,8 @@ routes:
|
||||||
|
|
||||||
Quelques changements ont eu lieu qui impactent les procédures indiquées ci-dessous :
|
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.
|
- 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.
|
- 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)
|
### 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 :
|
Les certificats et la clé privée doivent ressembler à cela :
|
||||||
|
|
||||||
```plaintext
|
```text
|
||||||
-----BEGIN CERTIFICATE-----
|
-----BEGIN CERTIFICATE-----
|
||||||
MIICVDCCAb0CAQEwDQYJKoZIhvcNAQEEBQAwdDELMAkGA1UEBhMCRlIxFTATBgNV
|
MIICVDCCAb0CAQEwDQYJKoZIhvcNAQEEBQAwdDELMAkGA1UEBhMCRlIxFTATBgNV
|
||||||
BAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UEChMDTExC
|
BAgTDENvcnNlIGR1IFN1ZDEQMA4GA1UEBxMHQWphY2NpbzEMMAoGA1UEChMDTExC
|
||||||
|
@ -142,4 +142,4 @@ Rechargez la configuration de NGINX pour prendre en compte le nouveau certificat
|
||||||
sudo service nginx reload
|
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 <a href="https://www.geocerts.com/ssl_checker" target="_blank"geocerts</a.
|
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 <a href="<https://www.geocerts.com/ssl_checker>" target="_blank"geocerts</a.
|
||||||
|
|
|
@ -11,8 +11,8 @@ routes:
|
||||||
|
|
||||||
Some changes have taken place which impact the procedures indicated below:
|
Some changes have taken place which impact the procedures indicated below:
|
||||||
|
|
||||||
* Metronome group is no longer used directly but ssl-cert.
|
- Metronome group is no longer used directly but ssl-cert.
|
||||||
* A `/etc/yunohost/certs/DOMAIN.LTD-history/stamp` directory is used to keep each configuration created and a symlink is created.
|
- A `/etc/yunohost/certs/DOMAIN.LTD-history/stamp` directory is used to keep each configuration created and a symlink is created.
|
||||||
|
|
||||||
### Adding a signed certificate by an authority (other than Let's Encrypt)
|
### Adding a signed certificate by an authority (other than Let's Encrypt)
|
||||||
|
|
||||||
|
@ -141,4 +141,4 @@ Reload NGINX configuration to take into account the new certificate.
|
||||||
sudo service nginx reload
|
sudo service nginx reload
|
||||||
```
|
```
|
||||||
|
|
||||||
Your certificate is ready. However, you can ensure that it is in place by testing the certificate using the <a href="https://www.geocerts.com/ssl_checker" target="_blank"geocerts</a.
|
Your certificate is ready. However, you can ensure that it is in place by testing the certificate using the <a href="<https://www.geocerts.com/ssl_checker>" target="_blank"geocerts</a.
|
||||||
|
|
|
@ -13,9 +13,9 @@ Tous les protocoles que YunoHost utilise sont **chiffrés**, les mots de passe n
|
||||||
|
|
||||||
Deux points sont néanmoins importants à noter :
|
Deux points sont néanmoins importants à noter :
|
||||||
|
|
||||||
* L’installation d’applications supplémentaires **augmente le nombre de failles** potentielles. Il est donc conseillé de se renseigner sur chacune d’elle **avant l’installation**, d’en comprendre le fonctionnement et juger ainsi l’impact que provoquerait une potentielle attaque. N’installez **que** les applications qui semblent importantes pour votre usage.
|
- L’installation d’applications supplémentaires **augmente le nombre de failles** potentielles. Il est donc conseillé de se renseigner sur chacune d’elle **avant l’installation**, d’en comprendre le fonctionnement et juger ainsi l’impact que provoquerait une potentielle attaque. N’installez **que** les applications qui semblent importantes pour votre usage.
|
||||||
|
|
||||||
* Le fait que YunoHost soit un logiciel répandu augmente les chances de subir une attaque. Si une faille est découverte, elle peut potentiellement **toucher toutes les instances YunoHost** à un temps donné. Nous nous efforçons de corriger ces failles le plus rapidement possible, pensez donc à **mettre à jour régulièrement** votre système.
|
- Le fait que YunoHost soit un logiciel répandu augmente les chances de subir une attaque. Si une faille est découverte, elle peut potentiellement **toucher toutes les instances YunoHost** à un temps donné. Nous nous efforçons de corriger ces failles le plus rapidement possible, pensez donc à **mettre à jour régulièrement** votre système.
|
||||||
|
|
||||||
!!!! Si vous avez besoin de conseil, n’hésitez pas à [nous demander](/help).
|
!!!! Si vous avez besoin de conseil, n’hésitez pas à [nous demander](/help).
|
||||||
|
|
||||||
|
|
|
@ -11,9 +11,9 @@ YunoHost è stato sviluppato per la migliore sicurezza senza troppe complicazion
|
||||||
|
|
||||||
Rimangono due punti importanti da notare:
|
Rimangono due punti importanti da notare:
|
||||||
|
|
||||||
* L'installazione di applicazioni addizionali può **aumentare significativamente** il numero di potenziali problemi di sicurezza. È importante chiedere informazioni relative a problemi di sicurezza **prima di installare un'applicazione** e provare ad installare solo le applicazioni necessarie.
|
- L'installazione di applicazioni addizionali può **aumentare significativamente** il numero di potenziali problemi di sicurezza. È importante chiedere informazioni relative a problemi di sicurezza **prima di installare un'applicazione** e provare ad installare solo le applicazioni necessarie.
|
||||||
|
|
||||||
* Poiché YunoHost è un software molto conosciuto ed usato aumenta le possibilità di un attacco. Se viene scoperto un problema potrebbe essere usato contemporaneamente contro tutte le istanze. Mantenete **aggiornato** il vostro sistema per aumentare la sicurezza. Gli aggiornamenti possono essere automatizzati installando l'[applicazione "Unattended_upgrades"](https://install-app.yunohost.org/?app=unattended_upgrades).
|
- Poiché YunoHost è un software molto conosciuto ed usato aumenta le possibilità di un attacco. Se viene scoperto un problema potrebbe essere usato contemporaneamente contro tutte le istanze. Mantenete **aggiornato** il vostro sistema per aumentare la sicurezza. Gli aggiornamenti possono essere automatizzati installando l'[applicazione "Unattended_upgrades"](https://install-app.yunohost.org/?app=unattended_upgrades).
|
||||||
|
|
||||||
!!!! Se avete bisogno di aiuto non esitate a [chiedere](/help).
|
!!!! Se avete bisogno di aiuto non esitate a [chiedere](/help).
|
||||||
|
|
||||||
|
|
|
@ -11,9 +11,9 @@ YunoHost has been developed to provide the best security without too much compli
|
||||||
|
|
||||||
Two things remain important to note:
|
Two things remain important to note:
|
||||||
|
|
||||||
* Installing additional apps can **significantly increase** the number of potential security flaws. Do not hesitate to get information about security flaws **before installing an app**, and try to only install apps which will suit your needs.
|
- Installing additional apps can **significantly increase** the number of potential security flaws. Do not hesitate to get information about security flaws **before installing an app**, and try to only install apps which will suit your needs.
|
||||||
|
|
||||||
* The fact that YunoHost is a well-known and used piece of software increases the chances of an attack. If a flaw is discovered, it could potentially affect all YunoHost instances at once. Keep your system **up-to-date** to remain safe. Updates can be automated by installing the ["Unattended_upgrades" app](https://install-app.yunohost.org/?app=unattended_upgrades).
|
- The fact that YunoHost is a well-known and used piece of software increases the chances of an attack. If a flaw is discovered, it could potentially affect all YunoHost instances at once. Keep your system **up-to-date** to remain safe. Updates can be automated by installing the ["Unattended_upgrades" app](https://install-app.yunohost.org/?app=unattended_upgrades).
|
||||||
|
|
||||||
!!!! If you need advice, do not hesitate to [ask us](/help).
|
!!!! If you need advice, do not hesitate to [ask us](/help).
|
||||||
|
|
||||||
|
|
|
@ -13,7 +13,7 @@ Cette page va vous aider à diagnostiquer, obtenir un accès et si besoin répar
|
||||||
|
|
||||||
## Vous avez accès au serveur via l'adresse IP, mais pas avec le nom de domaine ?
|
## Vous avez accès au serveur via l'adresse IP, mais pas avec le nom de domaine ?
|
||||||
|
|
||||||
#### Si vous êtes auto-hébergé à la maison : il faut configurer les redirection de ports
|
### Si vous êtes auto-hébergé à la maison : il faut configurer les redirection de ports
|
||||||
|
|
||||||
Vérifier que vous arrivez à accéder au serveur en utilisant son IP globale (que vous pouvez trouver sur <https://ip.yunohost.org>). Si cela ne fonctionne pas:
|
Vérifier que vous arrivez à accéder au serveur en utilisant son IP globale (que vous pouvez trouver sur <https://ip.yunohost.org>). 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:
|
- 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)
|
- utiliser une connexion cellulaire (4/5G)
|
||||||
- modifier le fichier /etc/hosts sur vos équipements
|
- 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)
|
(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 <https://www.whatsmydns.net/> avec l'IP globale de votre serveur (si vous êtes hébergé à la maison, vous pouvez obtenir cette IP sur <https://ip.yunohost.org>)
|
Vous pouvez valider que les enregistrements DNS sont corrects en comparant le résultat de <https://www.whatsmydns.net/> avec l'IP globale de votre serveur (si vous êtes hébergé à la maison, vous pouvez obtenir cette IP sur <https://ip.yunohost.org>)
|
||||||
|
|
||||||
#### 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 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`.
|
- 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 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).
|
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`.
|
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.
|
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.
|
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).
|
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'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.
|
- 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.
|
Vous pouvez le vérifier en tentant de faire des ping sur votre serveur en IPv4 et en IPv6.
|
||||||
|
|
||||||
|
|
|
@ -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
|
## 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:
|
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).
|
- 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.
|
- 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`
|
! 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).
|
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 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`.
|
- 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
|
## 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.
|
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`.
|
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.
|
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.
|
!!!! 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.
|
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 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.
|
- 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:
|
You can check that by `ping`ing it:
|
||||||
|
|
||||||
|
|
|
@ -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
|
## 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:
|
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)
|
- 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.
|
- 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`)
|
! 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).
|
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.
|
- 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`.
|
- 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 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.
|
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`.
|
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.
|
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.
|
!!!! 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).
|
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 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.
|
- 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:
|
You can check that by `ping`ing it:
|
||||||
|
|
||||||
|
|
|
@ -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 :
|
Il faut ajouter dans le fichier de configuration :
|
||||||
|
|
||||||
* votre identifiant et votre mot de passe DynHost
|
- votre identifiant et votre mot de passe DynHost
|
||||||
* votre nom de domaine
|
- votre nom de domaine
|
||||||
|
|
||||||
Il existe un [guide d'utilisation DynHost fait par OVH](https://docs.ovh.com/fr/fr/web/domains/utilisation-dynhost/).
|
Il existe un [guide d'utilisation DynHost fait par OVH](https://docs.ovh.com/fr/fr/web/domains/utilisation-dynhost/).
|
||||||
|
|
|
@ -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:
|
Nel file di configurazione di ddclient dovrete aggiungere:
|
||||||
|
|
||||||
* il vostro user e la vostra password DynHost
|
- il vostro user e la vostra password DynHost
|
||||||
* il nome del vostro dominio
|
- il nome del vostro dominio
|
||||||
|
|
||||||
Seguite anche questa [guida creata da OVH](https://docs.ovh.com/fr/fr/web/domains/utilisation-dynhost/).
|
Seguite anche questa [guida creata da OVH](https://docs.ovh.com/fr/fr/web/domains/utilisation-dynhost/).
|
||||||
|
|
|
@ -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:
|
You need to add in the configuration file:
|
||||||
|
|
||||||
* your login and password DynHost
|
- your login and password DynHost
|
||||||
* your domain name
|
- your domain name
|
||||||
|
|
||||||
You should also check out [OVH's guide on DynHost](https://www.ovh.co.uk/g2024.hosting_dynhost).
|
You should also check out [OVH's guide on DynHost](https://www.ovh.co.uk/g2024.hosting_dynhost).
|
||||||
|
|
|
@ -11,21 +11,21 @@ routes:
|
||||||
|
|
||||||
*Trouvez la liste d’autres fournisseurs d’accès à Internet **[ici](/isp)**.*
|
*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/).
|
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.
|
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).
|
[Liste des ports à ouvrir](/isp_box_config).
|
||||||
|
|
||||||
##### Freebox ≤ v5
|
### Freebox ≤ v5
|
||||||
|
|
||||||
Cela se passe dans la section *Ma Freebox / Configurer mon routeur*. Il faut :
|
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.
|
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)
|
[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/).
|
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 ».
|
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`
|
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
|
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` :
|
Une ligne à ajouter à la fin du `/etc/fstab` :
|
||||||
|
|
||||||
|
|
|
@ -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)** | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
|
| **[UPnP](https://fr.wikipedia.org/wiki/Universal_Plug_and_Play)** | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
|
||||||
| **[Port 25 ouvrable](/email)**<br> (fermé par défaut) | ✔ | ✔ | ✔ | ✘ | ✔ | ✔ |
|
| **[Port 25 ouvrable](/email)**<br> (fermé par défaut) | ✔ | ✔ | ✔ | ✘ | ✔ | ✔ |
|
||||||
| **[Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning)** | ✔ | ✔ | ✔/✘ | ✔ (depuis la Livebox 4) | ✔ | ✔ |
|
| **[Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning)** | ✔ | ✔ | ✔/✘ | ✔ (depuis la Livebox 4) | ✔ | ✔ |
|
||||||
| **[Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)<br>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)<br>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) | ✔ | ✔ |
|
| **[IP fixe](/dns_dynamicip)** | ✔ | ✔ | ✔/✘ | ✘ (en option depuis la Livebox 3 et sur les abonnements orange pro) | ✔ | ✔ |
|
||||||
| **[IPv6](https://fr.wikipedia.org/wiki/IPv6)** | ✔ | ✔ | ✔ | ✔ | … | … |
|
| **[IPv6](https://fr.wikipedia.org/wiki/IPv6)** | ✔ | ✔ | ✔ | ✔ | … | … |
|
||||||
| **[Non listé sur le DUL](https://en.wikipedia.org/wiki/Dialup_Users_List)** | … | ✘ | … | … | … | … |
|
| **[Non listé sur le DUL](https://en.wikipedia.org/wiki/Dialup_Users_List)** | … | ✘ | … | … | … | … |
|
||||||
|
|
|
@ -11,7 +11,7 @@ routes:
|
||||||
|
|
||||||
*Trouvez la liste d’autres fournisseurs d’accès à Internet **[ici](/isp)**.*
|
*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.
|
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
|
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)**.
|
Si vous avez une erreur "Authentification requise", la solution est la suivante : **[source](http://viruslocker.free.fr/?page_id=1749)**.
|
||||||
|
|
||||||
|
|
|
@ -11,14 +11,14 @@ routes:
|
||||||
|
|
||||||
*Trouvez la liste d’autres fournisseurs d’accès à Internet **[ici](/isp)**.*
|
*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 : <http://192.168.1.1>
|
- Allez à cette adresse : <http://192.168.1.1>
|
||||||
* Authentifiez-vous, soit en appuyant sur le bouton de la box pendant 5 secondes soit avec les identifiants d’administration.
|
- Authentifiez-vous, soit en appuyant sur le bouton de la box pendant 5 secondes soit avec les identifiants d’administration.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
#### Courrier électronique
|
## Courrier électronique
|
||||||
|
|
||||||
Pour pouvoir envoyer des mails, il faut désactiver le filtrage.
|
Pour pouvoir envoyer des mails, il faut désactiver le filtrage.
|
||||||
|
|
||||||
|
|
|
@ -21,7 +21,7 @@ Below, you can find a list of providers compatible for self-hosting and especial
|
||||||
!!! - port forwarding or opened features
|
!!! - port forwarding or opened features
|
||||||
!!! - net neutrality: no traffic analysis, no user data resale, no alteration of traffic (without legal obligations)...
|
!!! - net neutrality: no traffic analysis, no user data resale, no alteration of traffic (without legal obligations)...
|
||||||
|
|
||||||
------------------
|
---
|
||||||
|
|
||||||
## English speaking-site
|
## English speaking-site
|
||||||
|
|
||||||
|
|
|
@ -10,11 +10,11 @@ routes:
|
||||||
|
|
||||||
## PHP or HTML/JS apps
|
## 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
|
## 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.
|
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.
|
||||||
|
|
||||||
|
|
|
@ -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!
|
! **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
|
## Creating your own theme
|
||||||
|
|
||||||
|
|
|
@ -32,7 +32,7 @@ Um ein neues Konto in Thunderbird manuell zu konfigurieren, fügen Sie die Konto
|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
* [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]
|
||||||
[ui-tab title="K-9 Mail"]
|
[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.
|
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!
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||
|
|
|
@ -26,7 +26,7 @@ Para configurar manualmente un nuevo cuenta en Thunderbird, añadir las informac
|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
* [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)
|
||||||
|
|
||||||
###  Configurar K-9 Mail (en Android)
|
###  Configurar K-9 Mail (en Android)
|
||||||
|
|
||||||
|
|
|
@ -32,7 +32,7 @@ Pour configurer manuellement un nouveau compte dans Thunderbird commencez par re
|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
|
- [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
|
||||||
|
|
||||||
[/ui-tab]
|
[/ui-tab]
|
||||||
|
|
||||||
|
|
|
@ -32,7 +32,7 @@ Per configurare manualmente un nuovo account in Thunderbird, iniziate ad inserir
|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
* [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]
|
||||||
[ui-tab title="K-9 Mail"]
|
[ui-tab title="K-9 Mail"]
|
||||||
|
|
|
@ -32,7 +32,7 @@ To manually configure a new account in Thunderbird, add the account information,
|
||||||

|

|
||||||

|

|
||||||
|
|
||||||
* [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]
|
||||||
[ui-tab title="K-9 Mail"]
|
[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.
|
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!
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||
|
|
|
@ -50,6 +50,7 @@ Aquí tienes una lista más exhaustiva de clientes XMPP (en) : <https://xmpp.org
|
||||||
### Cifrar tu conversaciones con OMEMO
|
### Cifrar tu conversaciones con OMEMO
|
||||||
|
|
||||||
Es posible cifrar tu conversaciones XMPP con la ayuda de [OMEMO](https://xmpp.org/extensions/xep-0384.html), por ejemplo utilizando Gajim :
|
Es posible cifrar tu conversaciones XMPP con la ayuda de [OMEMO](https://xmpp.org/extensions/xep-0384.html), por ejemplo utilizando Gajim :
|
||||||
|
|
||||||
- Instalar `gajim` y el plugin `gajim-omemo`
|
- Instalar `gajim` y el plugin `gajim-omemo`
|
||||||
- Activar el plugin en `Tools > Plugins`
|
- Activar el plugin en `Tools > Plugins`
|
||||||
- Activar el cifrado en una conversación con un contacto que también tiene OMEMO activado.
|
- Activar el cifrado en una conversación con un contacto que también tiene OMEMO activado.
|
||||||
|
|
|
@ -19,34 +19,34 @@ Puede unirse a una sala de chat utilizando :
|
||||||
|
|
||||||
Existen salas publicas de chat de [soporte](/help) y ayuda para YunoHost:
|
Existen salas publicas de chat de [soporte](/help) y ayuda para YunoHost:
|
||||||
|
|
||||||
- IRC: **#yunohost** on libera.chat ;
|
- IRC: **`#yunohost`** on libera.chat ;
|
||||||
- Matrix: **[#yunohost:matrix.org](https://matrix.to/#/#yunohost:matrix.org)** ;
|
- Matrix: **[`#yunohost:matrix.org`](https://matrix.to/#/#yunohost:matrix.org)** ;
|
||||||
- XMPP: **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
|
- XMPP: **[`support@conference.yunohost.org`](xmpp:support@conference.yunohost.org?join)**
|
||||||
|
|
||||||
#### sala de chat para desarrolladores
|
#### sala de chat para desarrolladores
|
||||||
|
|
||||||
Salas de chat para el desarollo de YunoHost:
|
Salas de chat para el desarollo de YunoHost:
|
||||||
|
|
||||||
- IRC: **#yunohost-dev** on libera.chat ;
|
- IRC: **`#yunohost-dev`** on libera.chat ;
|
||||||
- Matrix: **#[yunohost-dev:matrix.org](https://matrix.to/#/#yunohost-dev: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)**
|
- XMPP: **[`dev@conference.yunohost.org`](xmpp:dev@conference.yunohost.org?join)**
|
||||||
|
|
||||||
Actualmente, la sala principal de chat para contribuciones en YunoHost
|
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
|
#### 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.
|
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
|
- IRC: **`#yunohost-apps`** en libera.chat
|
||||||
- Matrix: **[#yunohost-apps:matrix.org](https://matrix.to/#/#yunohost-apps:matrix.org)**
|
- Matrix: **[`#yunohost-apps:matrix.org`](https://matrix.to/#/#yunohost-apps:matrix.org)**
|
||||||
- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
|
- XMPP: **[`apps@conference.yunohost.org`](xmpp:apps@conference.yunohost.org?join)**
|
||||||
|
|
||||||
#### Sala de chat de Documentación
|
#### 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...)
|
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.).
|
Puede tambien compartir sus materiales sobre YunoHost (videos, presentaciones, etc.).
|
||||||
|
|
||||||
- IRC: **#yunohost-doc** on libera.chat
|
- IRC: **`#yunohost-doc`** on libera.chat
|
||||||
- Matrix: **[#yunohost-doc:matrix.org](https://matrix.to/#/#yunohost-doc:matrix.org)**
|
- Matrix: **[`#yunohost-doc:matrix.org`](https://matrix.to/#/#yunohost-doc:matrix.org)**
|
||||||
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**
|
- XMPP: **[`doc@conference.yunohost.org`](xmpp:doc@conference.yunohost.org?join)**
|
||||||
|
|
|
@ -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.
|
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)
|
- IRC : **`#yunohost`** sur libera.chat (voir KiwiIRC ci-dessus)
|
||||||
- Matrix : **[#yunohost:matrix.org](https://matrix.to/#/#yunohost:matrix.org)**
|
- Matrix : **[`#yunohost:matrix.org`](https://matrix.to/#/#yunohost:matrix.org)**
|
||||||
- XMPP : **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
|
- XMPP : **[`support@conference.yunohost.org`](xmpp:support@conference.yunohost.org?join)**
|
||||||
|
|
||||||
#### Développement
|
#### Développement
|
||||||
|
|
||||||
Salon de développement du cœur de YunoHost :
|
Salon de développement du cœur de YunoHost :
|
||||||
|
|
||||||
- IRC : **#yunohost-dev** sur libera.chat
|
- IRC : **`#yunohost-dev`** sur libera.chat
|
||||||
- Matrix : **[#yunohost-dev:matrix.org](https://matrix.to/#/#yunohost-dev:matrix.org)**
|
- Matrix : **[`#yunohost-dev:matrix.org`](https://matrix.to/#/#yunohost-dev:matrix.org)**
|
||||||
- XMPP : **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
|
- XMPP : **[`dev@conference.yunohost.org`](xmpp:dev@conference.yunohost.org?join)**
|
||||||
|
|
||||||
C'est le salon principal pour les contributions autour du projet.
|
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.
|
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.
|
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.
|
Il sert également à discuter de l’évolution du packaging, des outils d’intégration continue sur les applications.
|
||||||
|
|
||||||
- IRC : **#yunohost-apps** sur libera.chat
|
- IRC : **`#yunohost-apps`** sur libera.chat
|
||||||
- Matrix : **[#yunohost-apps:matrix.org](https://matrix.to/#/#yunohost-apps:matrix.org)**
|
- Matrix : **[`#yunohost-apps:matrix.org`](https://matrix.to/#/#yunohost-apps:matrix.org)**
|
||||||
- XMPP : **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
|
- XMPP : **[`apps@conference.yunohost.org`](xmpp:apps@conference.yunohost.org?join)**
|
||||||
|
|
||||||
#### Documentation
|
#### 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é...
|
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.
|
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
|
- IRC : **`#yunohost-doc`** sur libera.chat
|
||||||
- Matrix : **[#yunohost-doc:matrix.org](https://matrix.to/#/#yunohost-doc:matrix.org)**
|
- Matrix : **[`#yunohost-doc:matrix.org`](https://matrix.to/#/#yunohost-doc:matrix.org)**
|
||||||
- XMPP : **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**
|
- XMPP : **[`doc@conference.yunohost.org`](xmpp:doc@conference.yunohost.org?join)**
|
||||||
|
|
|
@ -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.
|
There is a [support](/help) chat room for YunoHost users mutual support and help.
|
||||||
|
|
||||||
- IRC: **#yunohost** on libera.chat
|
- IRC: **`#yunohost`** on libera.chat
|
||||||
- Matrix: **[#yunohost:matrix.org](https://matrix.to/#/#yunohost:matrix.org)**
|
- Matrix: **[`#yunohost:matrix.org`](https://matrix.to/#/#yunohost:matrix.org)**
|
||||||
- XMPP: **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
|
- XMPP: **[`support@conference.yunohost.org`](xmpp:support@conference.yunohost.org?join)**
|
||||||
|
|
||||||
#### Development chat room
|
#### Development chat room
|
||||||
|
|
||||||
YunoHost core development chat room:
|
YunoHost core development chat room:
|
||||||
|
|
||||||
- IRC: **#yunohost-dev** on libera.chat
|
- IRC: **`#yunohost-dev`** on libera.chat
|
||||||
- Matrix: **[#yunohost-dev:matrix.org](https://matrix.to/#/#yunohost-dev:matrix.org)**
|
- Matrix: **[`#yunohost-dev:matrix.org`](https://matrix.to/#/#yunohost-dev:matrix.org)**
|
||||||
- XMPP: **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
|
- XMPP: **[`dev@conference.yunohost.org`](xmpp:dev@conference.yunohost.org?join)**
|
||||||
|
|
||||||
Currently, the main chat room for contributions on YunoHost project.
|
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
|
#### Applications chat room
|
||||||
|
|
||||||
Application packaging development chat room. It allow packagers to help each other.
|
Application packaging development chat room. It allow packagers to help each other.
|
||||||
It also allow to discuss packaging evolution, continuous integration tools:
|
It also allow to discuss packaging evolution, continuous integration tools:
|
||||||
|
|
||||||
- IRC: **#yunohost-apps** on libera.chat
|
- IRC: **`#yunohost-apps`** on libera.chat
|
||||||
- Matrix: **[#yunohost-apps:matrix.org](https://matrix.to/#/#yunohost-apps:matrix.org)**
|
- Matrix: **[`#yunohost-apps:matrix.org`](https://matrix.to/#/#yunohost-apps:matrix.org)**
|
||||||
- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
|
- XMPP: **[`apps@conference.yunohost.org`](xmpp:apps@conference.yunohost.org?join)**
|
||||||
|
|
||||||
#### Documentation chat room
|
#### 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...).
|
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.
|
You may also share here your public communications about YunoHost (videos, presentations, etc.), to allow proper referencing.
|
||||||
|
|
||||||
- IRC: **#yunohost-doc** on libera.chat
|
- IRC: **`#yunohost-doc`** on libera.chat
|
||||||
- Matrix: **[#yunohost-doc:matrix.org](https://matrix.to/#/#yunohost-doc:matrix.org)**
|
- Matrix: **[`#yunohost-doc:matrix.org`](https://matrix.to/#/#yunohost-doc:matrix.org)**
|
||||||
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**
|
- XMPP: **[`doc@conference.yunohost.org`](xmpp:doc@conference.yunohost.org?join)**
|
||||||
|
|
|
@ -7,7 +7,7 @@ routes:
|
||||||
default: '/faq'
|
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.
|
I pacchetti che si trovano in YunoHost sono rilasciati con licenza GNU AGPL v.3.
|
||||||
|
|
||||||
|
|
|
@ -11,32 +11,32 @@ routes:
|
||||||
|
|
||||||
## Revenus attendus
|
## Revenus attendus
|
||||||
|
|
||||||
- Dons via Liberapay : 3000€
|
- Dons via Liberapay : 3000 €
|
||||||
- Subvention de NLNet : 20K€
|
- Subvention de NLNet : 20K €
|
||||||
|
|
||||||
## Dépenses prévues
|
## Dépenses prévues
|
||||||
|
|
||||||
- Developpement : 20K€
|
- Developpement : 20K €
|
||||||
- Location Serveur : ~500 €
|
- Location Serveur : ~500 €
|
||||||
- VPS Scaleway: 20.33-12: 243.96€/year
|
- VPS Scaleway: 20.33-12: 243.96 €/year
|
||||||
- VPS Digital O. (forum): 172.80€/year
|
- VPS Digital O. (forum): 172.80 €/year
|
||||||
- Noms de domaine : ~150 €
|
- Noms de domaine : ~150 €
|
||||||
- nohost.me : 11.99 €HT/ans
|
- `nohost.me` : 11.99 €HT/ans
|
||||||
- ynh.fr : 6.99 €HT/ans (doit être confirmé avec frju ?)
|
- `ynh.fr` : 6.99 €HT/ans (doit être confirmé avec frju ?)
|
||||||
- noho.st : ~35 €TTC/ans
|
- `noho.st` : ~35 €TTC/ans
|
||||||
- yunohost.org : 13.99 €HT/ans
|
- `yunohost.org` : 13.99 €HT/ans
|
||||||
- yunohost.com : 9.99 €HT/ans
|
- `yunohost.com` : 9.99 €HT/ans
|
||||||
- labriqueinter.net : 12.49 €Ht/ans
|
- `labriqueinter.net` : 12.49 €Ht/ans
|
||||||
- internetcu.be : 17.99 €HT/ans
|
- `internetcu.be` : 17.99 €HT/ans
|
||||||
- Communication : ~400 €
|
- Communication : ~400 €
|
||||||
- Stickers : 100€
|
- Stickers : 100 €
|
||||||
- Tracts : 100€
|
- Tracts : 100 €
|
||||||
- T-shirt : 200€
|
- T-shirt : 200 €
|
||||||
- Déplacements (ex. : aller aux conférences) : ~700 €
|
- Déplacements (ex. : aller aux conférences) : ~700 €
|
||||||
- AG FFDN 2020 : 225€ (en tout)
|
- AG FFDN 2020 : 225 € (en tout)
|
||||||
- Event colibris : 150€
|
- Event colibris : 150 €
|
||||||
- FOSDEM ou autre conf : 300€
|
- FOSDEM ou autre conf : 300 €
|
||||||
- Compte bancaire fees : 7×12 € soit ~100 €
|
- Compte bancaire fees : 7×12 € soit ~100 €
|
||||||
- Brique Camp : 500€
|
- Brique Camp : 500 €
|
||||||
|
|
||||||
--Balance 2020-2021-- : +650 €
|
--Balance 2020-2021-- : +650 €
|
||||||
|
|
|
@ -21,13 +21,13 @@ routes:
|
||||||
- VPS Scaleway: 20.33-12: 243.96€/year
|
- VPS Scaleway: 20.33-12: 243.96€/year
|
||||||
- VPS Digital O. (forum): 172.80€/year
|
- VPS Digital O. (forum): 172.80€/year
|
||||||
- Domain names: ~150€
|
- Domain names: ~150€
|
||||||
- nohost.me: 11.99€HT/year
|
- `nohost.me`: 11.99€HT/year
|
||||||
- ynh.fr: 6.99€HT/year (to be confirmed with frju?)
|
- `ynh.fr`: 6.99€HT/year (to be confirmed with frju?)
|
||||||
- noho.st: ~35€ TTC/year
|
- `noho.st`: ~35€ TTC/year
|
||||||
- YunoHost.org: 13.99€HT/year
|
- `yunohost.org`: 13.99€HT/year
|
||||||
- YunoHost.com: 9.99€HT/year
|
- `yunohost.com`: 9.99€HT/year
|
||||||
- labriqueinter.net: 12.49€HT/year
|
- `labriqueinter.net`: 12.49€HT/year
|
||||||
- internetcu.be: 17.99€HT/year
|
- `internetcu.be`: 17.99€HT/year
|
||||||
- Communication: ~400€
|
- Communication: ~400€
|
||||||
- Travel (e.g. to go to conferences): ~700€
|
- Travel (e.g. to go to conferences): ~700€
|
||||||
- AG FFDN 2020: 225€ (en tout)
|
- AG FFDN 2020: 225€ (en tout)
|
||||||
|
|
|
@ -206,23 +206,23 @@ Comme tel :
|
||||||
|
|
||||||
Ce qui affichera :
|
Ce qui affichera :
|
||||||
|
|
||||||
+ Liste 1
|
- Liste 1
|
||||||
+ Liste 2
|
- Liste 2
|
||||||
+ liste 3
|
- liste 3
|
||||||
+ Liste 3a
|
- Liste 3a
|
||||||
+ Liste 3b
|
- Liste 3b
|
||||||
+ Liste 3b1
|
- Liste 3b1
|
||||||
+ Liste 3b2
|
- Liste 3b2
|
||||||
+ Liste 3b3
|
- Liste 3b3
|
||||||
+ Liste 1
|
- Liste 1
|
||||||
+ Liste 2
|
- Liste 2
|
||||||
+ liste 3
|
- liste 3
|
||||||
|
|
||||||
- Liste 4
|
- Liste 4
|
||||||
|
|
||||||
* Liste 5
|
- Liste 5
|
||||||
|
|
||||||
+ liste 6
|
- liste 6
|
||||||
|
|
||||||
## Les tableaux
|
## Les tableaux
|
||||||
|
|
||||||
|
@ -273,9 +273,9 @@ Minimum trois accents graves en ouverture et fermeture de bloc et deux accents g
|
||||||
|
|
||||||
## Liens utiles
|
## Liens utiles
|
||||||
|
|
||||||
+ La documentation du langage originel Markdown : [daringfireball.net/projects/markdown (en)](https://daringfireball.net/projects/markdown/)
|
- La documentation du langage originel Markdown : [daringfireball.net/projects/markdown (en)](https://daringfireball.net/projects/markdown/)
|
||||||
+ Tutoriel Markdown sur [markdowntutorial.com](https://markdowntutorial.com)
|
- Tutoriel Markdown sur [markdowntutorial.com](https://markdowntutorial.com)
|
||||||
|
|
||||||
## Aller plus loin
|
## 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).
|
||||||
|
|
|
@ -206,23 +206,23 @@ As such:
|
||||||
|
|
||||||
This will read:
|
This will read:
|
||||||
|
|
||||||
+ List 1
|
- List 1
|
||||||
+ List 2
|
- List 2
|
||||||
+ list 3
|
- list 3
|
||||||
+ List 3a
|
- List 3a
|
||||||
+ List 3b
|
- List 3b
|
||||||
+ List 3b1
|
- List 3b1
|
||||||
+ List 3b2
|
- List 3b2
|
||||||
+ List 3b3
|
- List 3b3
|
||||||
+ List 1
|
- List 1
|
||||||
+ List 2
|
- List 2
|
||||||
+ list 3
|
- list 3
|
||||||
|
|
||||||
- List 4
|
- List 4
|
||||||
|
|
||||||
* List 5
|
- List 5
|
||||||
|
|
||||||
+ list 6
|
- list 6
|
||||||
|
|
||||||
## Tables
|
## Tables
|
||||||
|
|
||||||
|
@ -273,9 +273,9 @@ At least three low pitched accents at the opening and closing of the block and t
|
||||||
|
|
||||||
## Useful links
|
## Useful links
|
||||||
|
|
||||||
+ The documentation of the original Markdown language: [daringfireball.net/projects/markdown](https://daringfireball.net/projects/markdown/)
|
- The documentation of the original Markdown language: [daringfireball.net/projects/markdown](https://daringfireball.net/projects/markdown/)
|
||||||
+ Markdown Tutorial on [markdowntutorial.com](https://markdowntutorial.com)
|
- Markdown Tutorial on [markdowntutorial.com](https://markdowntutorial.com)
|
||||||
|
|
||||||
## Going further
|
## 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).
|
||||||
|
|
|
@ -7,9 +7,9 @@ routes:
|
||||||
default: '/doc_use_git'
|
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.
|
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`).
|
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
|
## 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.
|
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
|
## Aller plus loin avec Git et travailler sur son poste de travail
|
||||||
|
|
|
@ -7,9 +7,9 @@ routes:
|
||||||
default: '/doc_use_git'
|
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.
|
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`).
|
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
|
||||||

|

|
||||||
|
|
||||||
> **Point of vigilance !**
|
> **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.
|
> 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
|
## 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
|
## 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.
|
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
|
## Going further with Git and working on your workstation
|
||||||
|
|
|
@ -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 <small>(though not sure why this number?)</small>.
|
- `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 <small>(though not sure why this number?)</small>.
|
||||||
- `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`.
|
- `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.
|
- `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
|
## Upstream section
|
||||||
|
|
||||||
|
@ -88,7 +88,7 @@ ram.runtime = "1M"
|
||||||
|
|
||||||
This section is completely optional and, for most apps, doesn't exist at all.
|
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:
|
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
|
- `help.en` is an optional additional message to provide further info about this question
|
||||||
- `type` is the type of question, in this case `string`
|
- `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)
|
- 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
|
- .. and in the bash install script, the bash variable will automatically be available `$prefered_pet` with the chosen value
|
||||||
|
|
||||||
### Regarding install question types
|
### Regarding install question types
|
||||||
|
|
|
@ -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.
|
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/<whatever>.md`
|
## Specific notes for admins : `doc/ADMIN.md`, `doc/<whatever>.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_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_UPGRADE_TYPE: The type of upgrade (UPGRADE_PACKAGE, UPGRADE_APP, UPGRADE_FULL)
|
||||||
- YNH_APP_MANIFEST_VERSION: The version number
|
- 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_BACKUP_UPGRADE: 1 if we don't want to backup else 0
|
||||||
|
|
||||||
##### No positionnal arguments
|
##### No positionnal arguments
|
||||||
|
|
|
@ -8,6 +8,7 @@ routes:
|
||||||
---
|
---
|
||||||
|
|
||||||
Here comes the time:
|
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 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 have integrated the [YunoHost Apps Group](https://yunohost.org/#/project_organization)
|
||||||
- you know what means `¯\_(ツ)_/¯`
|
- 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.
|
Here are few ideas that could help you to improve YunoHost apps packaging.
|
||||||
|
|
||||||
Usually, there are things that slow you down:
|
Usually, there are things that slow you down:
|
||||||
|
|
||||||
- Installing your freshly done package because of dependencies installation or npm/rust/elixir/composer builds
|
- 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
|
- Waiting a package_check to see the level of your package
|
||||||
- etc...
|
- etc...
|
||||||
|
@ -23,9 +25,11 @@ Usually, there are things that slow you down:
|
||||||
The idea is to use YunoHost stuffs to help you improve this lost time.
|
The idea is to use YunoHost stuffs to help you improve this lost time.
|
||||||
|
|
||||||
## Building your infrastructure
|
## 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...
|
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:
|
After first installation of those VMs/LXCs, each one has to be reacheable with its domain name, like for example:
|
||||||
|
|
||||||
- ynh1.mydomain.org
|
- ynh1.mydomain.org
|
||||||
- ynh2.mydomain.org
|
- ynh2.mydomain.org
|
||||||
- ynh3.mydomain.org
|
- ynh3.mydomain.org
|
||||||
|
@ -36,6 +40,7 @@ If your are lucky enough to have IPV6 and a /64 IPV6 scope, it won't be a proble
|
||||||
Another way the DNS stuff is to simply use an hosts file.
|
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:
|
In addition, it's helpfull to have several domains names for each YunoHost, for example:
|
||||||
|
|
||||||
- ynh1.mydomain.org
|
- ynh1.mydomain.org
|
||||||
- test11.mydomain.org
|
- test11.mydomain.org
|
||||||
- test12.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
|
- test32.mydomain.org
|
||||||
- test33.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 <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)
|
||||||
|
|
||||||
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...
|
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
|
Example of a script to upgrade a master VirtualBox VM
|
||||||
|
|
||||||
```
|
```bash
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
# printers
|
# printers
|
||||||
|
@ -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
|
Example of a script to customize a cloned VM
|
||||||
|
|
||||||
```
|
```bash
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
master_domain=domain1.fr
|
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.
|
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
|
## Having your packages/commits available in each VMs/LXCs
|
||||||
|
|
||||||
There are several ways to have your freshly created package available from 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
|
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
|
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
|
Example of a script to mount as shared directory a packaging directory into a VirtualBox VM
|
||||||
|
|
||||||
```
|
```bash
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
|
||||||
shared_folder=my_directory
|
shared_folder=my_directory
|
||||||
|
@ -149,6 +155,7 @@ sudo mount -o defaults -t vboxsf $shared_folder "./$shared_folder"
|
||||||
```
|
```
|
||||||
|
|
||||||
## Shortcuts
|
## Shortcuts
|
||||||
|
|
||||||
Use and abuse of `yunohost app install` `--args` argument
|
Use and abuse of `yunohost app install` `--args` argument
|
||||||
|
|
||||||
You can do ugly thing considering mynewapp is the name/REPLACEBYYOURAPP of your app
|
You can do ugly thing considering mynewapp is the name/REPLACEBYYOURAPP of your app
|
||||||
|
@ -186,8 +193,6 @@ To upgrade your mynewapp
|
||||||
```bash
|
```bash
|
||||||
YNHAPP=mynewapp
|
YNHAPP=mynewapp
|
||||||
yunohost app upgrade ${YNHAPP} -f /mycentralrepo/${YNHAPP}_ynh/ --debug
|
yunohost app upgrade ${YNHAPP} -f /mycentralrepo/${YNHAPP}_ynh/ --debug
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
With that, you will be able to launch different actions on differents YunoHost VMs/LXCs
|
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.
|
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:
|
A good tool to keep your TODO list organized is to use a kaban like apps:
|
||||||
|
|
||||||
- [Kanboard](https://github.com/YunoHost-Apps/kanboard_ynh)
|
- [Kanboard](https://github.com/YunoHost-Apps/kanboard_ynh)
|
||||||
- [Wekan](https://github.com/YunoHost-Apps/wekan_ynh)
|
- [Wekan](https://github.com/YunoHost-Apps/wekan_ynh)
|
||||||
|
|
|
@ -13,6 +13,7 @@ Packaging v2 is a major improvement for the packaging introduced in YunoHost 11.
|
||||||
### Motivation
|
### Motivation
|
||||||
|
|
||||||
The motivations for this new format is:
|
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 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.
|
- 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.
|
- 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.
|
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
|
### Adapting a v1 app to v2
|
||||||
|
|
||||||
A script is available in <https://github.com/YunoHost/apps/tree/master/tools/packaging_v2> and will attempt to convert what it can from the v1 format to the v2 format, in particular:
|
A script is available in <https://github.com/YunoHost/apps/tree/master/tools/packaging_v2> 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
|
- initializing a `manifest.toml` and prefilling it with info scrapped from the various scripts
|
||||||
- comment out now-unecessary lines in the various scripts
|
- comment out now-unecessary lines in the various scripts
|
||||||
|
|
||||||
|
@ -62,7 +63,7 @@ The [example repo](https://github.com/YunoHost/example_ynh) illustrates the belo
|
||||||
- `doc/PRE_UPGRADE.d/{version}.md`: a note to be displayed prior to a specific version upgrade.
|
- `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?
|
- `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
|
- 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:
|
- **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)
|
- `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)
|
- `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)
|
- `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)
|
||||||
|
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Reference in a new issue