Misc fixes/improvements

This commit is contained in:
Alexandre Aubin 2021-02-13 21:06:52 +01:00
parent c7e4e9abb6
commit 14657ee188
4 changed files with 56 additions and 61 deletions

View file

@ -17,19 +17,20 @@ L'une de ces astuces devrait permettre de trouver l'IP locale de votre serveur :
[ui-tabs position="top-left" active="0" theme="lite"] [ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommandé) Avec AngryIP"] [ui-tab title="(Recommandé) Avec AngryIP"]
Vous pouvez utiliser le logiciel [AngryIP](https://angryip.org/download/) pour y parvenir. Vous devez juste scanner ces plages d'IP dans cet ordre jusqu'à trouver des IP actives : Vous pouvez utiliser le logiciel [AngryIP](https://angryip.org/download/) pour y parvenir. Vous devez juste scanner ces plages d'IP dans cet ordre jusqu'à trouver l'IP correspondante à votre serveur :
- 192.168.0.0 -> 192.168.0.255 - `192.168.0.0` -> `192.168.0.255`
- 192.168.1.0 -> 192.168.1.255 - `192.168.1.0` -> `192.168.1.255`
- 192.168.2.0 -> 192.168.255.255 - `192.168.2.0` -> `192.168.255.255`
- 10.0.0.0 -> 10.0.255.255 - `10.0.0.0` -> `10.0.255.255`
- 172.16.0.0 -> 172.31.255.255 - `172.16.0.0` -> `172.31.255.255`
!!! Astuce: vous pouvez ordonner par ping comme dans cette image. !!! **Astuces**:
!!! - vous pouvez ordonner par ping comme dans cette capture d'écran, pour voir plus facilement toutes les IP effectivement actives.
!!! - votre serveur devrait être monté comme écoutant sur les ports 80 et 443
!!! - en cas de doute, tapez directement dans votre navigateur `https://192.168.x.y` pour voir si c'est un Yunohost ou non.
![](image://angryip.png?class=inline) ![](image://angryip.png?class=inline)
Si vous trouvez des IPs avec un ping, vous pouvez essayer de les taper directement dans le navigateur pour voir si c'est une YunoHost ou non.
[/ui-tab] [/ui-tab]
[ui-tab title="Avec votre box internet"] [ui-tab title="Avec votre box internet"]
Utilisez l'interface de votre box internet pour lister les machines connectées. Utilisez l'interface de votre box internet pour lister les machines connectées.
@ -42,12 +43,13 @@ Si la commande `arp-scan` vous affiche beaucoup de machines, vous pouvez vérifi
[ui-tab title="With a screen"] [ui-tab title="With a screen"]
Branchez un écran sur votre serveur, loggez-vous et tapez `hostname --all-ip-address`. Branchez un écran sur votre serveur, loggez-vous et tapez `hostname --all-ip-address`.
Si vous ne connaissez pas les identifiants pour vous connecter, essayez les identifiants par défaut suivant : Les identifiants par défaut (avant la post-installation!) sont:
- login: root
- mot de passe: yunohost
(Si vous utilisez une image Armbian brute plutôt que les images Yunohost pré-installées, les identifiants sont root / 1234)
| login | mot de passe |
|---|---|
| root | yunohost |
| root | 1234 |
[/ui-tab] [/ui-tab]
[/ui-tabs] [/ui-tabs]

View file

@ -17,19 +17,20 @@ Any of these tricks should allow you to find the local IP of your server:
[ui-tabs position="top-left" active="0" theme="lite"] [ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Recommended) With AngryIP"] [ui-tab title="(Recommended) With AngryIP"]
You can use the [AngryIP](https://angryip.org/download/) software to achieve that. You just need to scan these local ip ranges in this order until you find some active IP: You can use the [AngryIP](https://angryip.org/download/) software to achieve that. You just need to scan these local ip ranges in this order until you find the active IP corresponding to your server:
- 192.168.0.0 -> 192.168.0.255 - `192.168.0.0` -> `192.168.0.255`
- 192.168.1.0 -> 192.168.1.255 - `192.168.1.0` -> `192.168.1.255`
- 192.168.2.0 -> 192.168.255.255 - `192.168.2.0` -> `192.168.255.255`
- 10.0.0.0 -> 10.0.255.255 - `10.0.0.0` -> `10.0.255.255`
- 172.16.0.0 -> 172.31.255.255 - `172.16.0.0` -> `172.31.255.255`
!!! Tips: you can order by ping like on this image. !!! **Tips**:
!!! - you can order by ping like on this screenshot to easily see effectively-used IP.
!!! - your server should typically be displayed as listening on port 80 and 443
!!! - in case of doubt, just type `https://192.168.x.y` in your browser to check if it's a Yunohost or not.
![](image://angryip.png?class=inline) ![](image://angryip.png?class=inline)
If you find some IPs with a ping, you can try to type it directly in a browser and see if it's a yunohost or not.
[/ui-tab] [/ui-tab]
[ui-tab title="With your internet router / box"] [ui-tab title="With your internet router / box"]
Connect to your internet box / router interface to list the machines connected. Connect to your internet box / router interface to list the machines connected.
@ -39,15 +40,14 @@ If you're using Linux, you can open a terminal and use `sudo arp-scan --local` t
If the `arp-scan` command displays a confusing number of devices, you can check which ones are open to SSH with `nmap -p 22 192.168.1.0/24` to sort them out (adapt the IP range to your local network) If the `arp-scan` command displays a confusing number of devices, you can check which ones are open to SSH with `nmap -p 22 192.168.1.0/24` to sort them out (adapt the IP range to your local network)
[/ui-tab] [/ui-tab]
[ui-tab title="With a screen"] [ui-tab title="With a direct access on the server"]
Plug a screen on your server, log in and type `hostname --all-ip-address`. Plug a screen on your server, log in and type `hostname --all-ip-address`.
If you don't know credentials to login, try the following default credentials: The default credentials (before post-installation!) to log in are:
- login: root
- password: yunohost
| login | password | (If you are using a raw Armbian image instead of the pre-installed Yunohost image, the credentials are root / 1234)
|---|---|
| root | yunohost |
| root | 1234 |
[/ui-tab] [/ui-tab]
[/ui-tabs] [/ui-tabs]

View file

@ -13,7 +13,7 @@ page-toc:
depth: 2 depth: 2
routes: routes:
default: '/install' default: '/install'
aliases: aliases:
- '/docker' - '/docker'
- '/install_iso' - '/install_iso'
- '/install_on_vps' - '/install_on_vps'
@ -177,7 +177,7 @@ Cependant, ces images communautaires existent et sont disponibles sur Docker Hub
* Une clé USB avec au moins 1Go de capacité OU un CD viege standard * Une clé USB avec au moins 1Go de capacité OU un CD viege standard
{% endif %} {% endif %}
{% if at_home %} {% if at_home %}
* Un [fournisseur d'accès correct](/isp), de préférence avec une bonne vitesse dupload * Un [fournisseur d'accès internet correct](/isp), de préférence avec une bonne vitesse dupload
{% if rpi0 %} {% if rpi0 %}
* Un câble OTG ou un adaptateur Wifi USB pour connecter votre Raspberry Pi Zero * Un câble OTG ou un adaptateur Wifi USB pour connecter votre Raspberry Pi Zero
{% elseif not virtualbox %} {% elseif not virtualbox %}
@ -190,7 +190,7 @@ Cependant, ces images communautaires existent et sont disponibles sur Docker Hub
{% endif %} {% endif %}
{% if virtualbox %} {% if virtualbox %}
! N.B. : Installer YunoHost dans une VirtualBox est utile pour tester la distribution. Pour réellement s'autohéberger sur le long terme, il vous faudra probablement une machine physique (vieil ordinateur, carte ARM...) ou un serveur en ligne. ! N.B. : Installer YunoHost dans une VirtualBox est utile pour tester la distribution. Pour réellement s'autohéberger sur le long terme, il vous faudra probablement une machine physique (vieil ordinateur, carte ARM...) ou un serveur en ligne.
{% endif %} {% endif %}
@ -216,13 +216,9 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
{% if virtualbox or regular %} {% if virtualbox or regular %}
!!! Si votre hôte est en 32 bits, faite bien attention à télécharger l'image 32 bits. !!! Si votre hôte est en 32 bits, faite bien attention à télécharger l'image 32 bits.
{% elseif arm_unsup %} {% elseif arm_unsup %}
<div class="hardware-image"> <a href="https://www.armbian.com/download/" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=external-link] Télécharger l'image pour votre carte sur le site d'Armbian</a>
<div class="card panel panel-default">
<div class="btn-group" role="group"> !!! N.B.: il vous faut télécharger l'image Armbian Buster.
<a href="https://www.armbian.com/download/" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Télécharger</a>
</div>
</div>
</div>
{% endif %} {% endif %}
@ -378,13 +374,14 @@ Allez dans **Réglages** > **Réseau** :
{% if arm %} {% if arm %}
## [fa=plug /] Démarrer la carte ## [fa=plug /] Démarrer la carte
* Branchez le cable ethernet (un cé à votre box, de 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.org/documentation/configuration/wireless/wireless-cli.md). * Pour les utilisateurs et utilisatrices souhaitant configurer la carte pour la connecter via le WiFi à la place, voir [cet exemple](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
* Mettez la carte SD dans le serveur * Mettez la carte SD dans le serveur
* (Faculatif) Il est possible de brancher un écran et clavier sur votre serveur en cas de soucis ou pour vérifier que le processus de démarrage (boot) se passe bien ou encore pour avoir un accès direct en console. * (Faculatif) Il est possible de brancher un écran et clavier sur votre serveur en cas de soucis ou 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 ordianteur (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
@ -424,7 +421,7 @@ Vous devriez voir un écran comme ça :
{% if rpi1 or rpi0 %} {% if rpi1 or rpi0 %}
## [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 dysfonctionnements avec metronome (XMPP) et avec miniupnpc (autoconfiguration de la box). Les Raspberry Pi 1 et 0 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.
@ -435,8 +432,8 @@ ssh root@yunohost.local
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}
ln -s /usr/bin/true /usr/bin/metronome ln -s /usr/bin/true /usr/bin/metronome
ln -s /usr/bin/true /usr/bin/metronomectl ln -s /usr/bin/true /usr/bin/metronomectl
``` ```
@ -451,7 +448,7 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
{% 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`.
``` ```
ssh root@192.168.x.xxx ssh root@192.168.x.xxx
@ -526,7 +523,7 @@ Cest le nom de domaine qui permettra laccès à votre serveur ainsi qua
* 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). * 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).
!!! 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 un faux domaine comme par exemple `yolo.test` et modifier votre fichier `/etc/hosts` 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` pour que ce domaine pointe vers l'IP de votre serveur, comme expliqué [ici](/dns_local_network).
##### [fa=key /] Mot de passe dadministration ##### [fa=key /] Mot de passe dadministration
Cest le mot de passe qui vous permettra daccéder à linterface dadministration de votre serveur. Vous pourrez également lutiliser pour vous connecter à distance [via SSH](/ssh), ou [en SFTP](/filezilla) pour transférer des fichiers. De manière générale, cest la **clé dentrée à votre système**, pensez donc à la choisir attentivement. Cest le mot de passe qui vous permettra daccéder à linterface dadministration de votre serveur. Vous pourrez également lutiliser pour vous connecter à distance [via SSH](/ssh), ou [en SFTP](/filezilla) pour transférer des fichiers. De manière générale, cest la **clé dentrée à votre système**, pensez donc à la choisir attentivement.
@ -535,7 +532,7 @@ Cest le mot de passe qui vous permettra daccéder à linterface dadm
Une fois la configuration initiale faite, vous devriez être capable de vous connecter à l'interface d'administration web en utilisant le mot de passe d'administration. Une fois la configuration initiale faite, vous devriez être capable de vous connecter à l'interface d'administration web en utilisant le mot de passe d'administration.
Bien que votre serveur connaisse l'utilisateur `admin`, cet utilisateur `admin` n'est pas un utilisateur "standard" et ne peut pas se connecter sur le [portail utilisateur](/users). Bien que votre serveur dispose maintenant d'un utilisateur `admin`, cet utilisateur `admin` n'est pas un utilisateur "standard" et ne peut pas se connecter sur le [portail utilisateur](/users).
Par conséquent, vous devriez ajouter un premier utilisateur "standard". Par conséquent, vous devriez ajouter un premier utilisateur "standard".
@ -560,9 +557,9 @@ TODO : copypasta an actual shell session will all info asked etc..
## [fa=stethoscope /] Lancer le diagnostic ## [fa=stethoscope /] Lancer le diagnostic
Le système de diagnostique est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configuré et pour vous guider dans la résolutions des problèmes soulevés. Le diagnostique se lance 2 fois par jour et envoie une alerte si un dysfonctionnement est détecté. Le système de diagnostique est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configuré et pour vous guider dans la résolution des problèmes soulevés. Le diagnostique se lance deux fois par jour et envoie une alerte si un dysfonctionnement est détecté.
!!! N.B. : **ne partez pas en courant** ! La première fois que vous lancerez le diagnostique, c'est assez normal d'avoir un tas d'alertes rouges ou jaunes parce que vous devez généralement [configurer les enregistrements DNS](/dns) (si vous n'utilisez pas un domaine `.nohost.me`, `.noho.st` ou `.ynh.fr`){%if at_home %} et/ou [configurer la redirection des ports](/isp_box_config){% endif %}. !!! N.B. : **ne partez pas en courant** ! La première fois que vous lancerez le diagnostique, il est assez normal d'avoir plusieurs alertes rouges ou jaunes car vous devez généralement [configurer les enregistrements DNS](/dns) (si vous n'utilisez pas un domaine `.nohost.me`, `.noho.st` ou `.ynh.fr`){%if at_home %} et/ou [configurer la redirection des ports](/isp_box_config){% endif %}.
!!! Si une alerte n'est pas pertinente (par exemple parce que vous ne pensez pas utiliser une fonctionnalité spécifique), il est tout à fait convenable d'indiquer le dysfonctionnement comme "A ignorer" en allant dans l'administration web > Diagnostic, et en cliquant sur bouton "Ignorer" pour ce dysfonctionnement spécifique. !!! Si une alerte n'est pas pertinente (par exemple parce que vous ne pensez pas utiliser une fonctionnalité spécifique), il est tout à fait convenable d'indiquer le dysfonctionnement comme "A ignorer" en allant dans l'administration web > Diagnostic, et en cliquant sur bouton "Ignorer" pour ce dysfonctionnement spécifique.
@ -605,8 +602,8 @@ yunohost domain cert-install
[/ui-tabs] [/ui-tabs]
{% endif %} {% endif %}
## ![](image://tada.png?resize=32&classes=inline) Félicitation ! ## ![](image://tada.png?resize=32&classes=inline) Félicitations !
Vous avez maintenant un serveur plutôt bien configuré. Si vous découvrez YunoHost, nous vous recommandons de jeter un oeil à [la visite guidée](/overview). Vous devriez aussi être en mesure d'[installer vos applications favorites](/apps). N'oubliez pas de [configurer les sauvegardes](/backup) ! Vous avez maintenant un serveur plutôt bien configuré. Si vous découvrez YunoHost, nous vous recommandons de jeter un oeil à [la visite guidée](/overview). Vous devriez aussi être en mesure d'[installer vos applications favorites](/apps). N'oubliez pas de [prévoir des sauvegardes](/backup) !
{% endif %} {% endif %}

View file

@ -216,13 +216,9 @@ Here are some VPS providers supporting YunoHost natively :
{% if virtualbox or regular %} {% if virtualbox or regular %}
!!! If your host OS is 32 bits, be sure to download the 32-bit image. !!! If your host OS is 32 bits, be sure to download the 32-bit image.
{% elseif arm_unsup %} {% elseif arm_unsup %}
<div class="hardware-image"> <a href="https://www.armbian.com/download/" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=external-link] Download the image for your board on Armbian's website</a>
<div class="card panel panel-default">
<div class="btn-group" role="group"> !!! N.B.: you should download the image Armbian Buster.
<a href="https://www.armbian.com/download/" target="_BLANK" type="button" class="btn btn-info col-sm-12">[fa=download] Download</a>
</div>
</div>
</div>
{% endif %} {% endif %}
@ -424,7 +420,7 @@ You should see a screen like this:
{% if rpi1 or rpi0 %} {% if rpi1 or rpi0 %}
## [fa=bug /] Connect to the board and hotfix the image ## [fa=bug /] Connect to the board and hotfix the image
Raspberry pi 1 or zero are not totally supported due to issues with metronome (XMPP) and with miniupnpc (router autoconfig). 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.
@ -537,7 +533,7 @@ This password will be used to access to your server's administration interface.
Once the postinstall is done, you should be able to actually log in the web admin interface using the administration password. Once the postinstall is done, you should be able to actually log in the web admin interface using the administration password.
So far, your server knows about the `admin` user - but `admin` is not a "regular" user and *can't* be used to log on [the user portal](/users). So far, your server now has an `admin` user - but `admin` is not a "regular" user and *can't* be used to log on [the user portal](/users).
Let's therefore add a first "regular" user. Let's therefore add a first "regular" user.
@ -609,6 +605,6 @@ yunohost domain cert-install
## ![](image://tada.png?resize=32&classes=inline) Congratz! ## ![](image://tada.png?resize=32&classes=inline) Congratz!
You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at [the guided tour](/overview). You should also be able to [install your favourite applications](/apps). Don't forget to [configure backups](/backup) ! You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at [the guided tour](/overview). You should also be able to [install your favourite applications](/apps). Don't forget to [plan backups](/backup) !
{% endif %} {% endif %}