Aller au contenu principal

Configuration post-installation

Lancer la configuration initiale​

astuce

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.

remarque

Cette documentation suppose que vous ĂȘtes sur le mĂȘme rĂ©seau local que votre YunoHost. Trouvez son adresse IP avant de continuer.

Pour un VPS, utilisez l'adresse IP publique au lieu du domaine ou adresse locale.

attention

Lors de la premiÚre visite, vous rencontrerez trÚs probablement un avertissement de sécurité lié au certificat utilisé. Pour le moment, votre serveur utilise un certificat auto-signé. Vous pourrez plus tard ajouter un certificat automatiquement reconnu par les navigateurs comme décrit dans la page sur les certificats. En attendant, ajoutez une exception de sécurité pour accepter le certificat actuel. Toutefois, s'il vous plaßt, ne prenez pas l'habitude d'accepter ce genre d'alerte de sécurité !

Vous devriez ensuite obtenir cette page :

Capture d'écran de la page de configuration initiale
Capture d'écran de la page de configuration initiale

Domaine principal​

Configuration spécifique WSL

Vous devrez choisir un faux nom de domaine, car il ne sera pas accessible de l'extérieur. Par exemple, ynh.wsl. L'étape compliqué est d'exposer ce nom de domaine à votre hÎte.

Éditez le fichier C:\Windows\System32\drivers\etc\hosts. Vous devriez avoir une ligne commençant par ::1, crĂ©ez la si elle n'existe pas, et rajoutez votre domaine Ă  la fin:

::1    ynh.wsl localhost

Si vous voulez des sous-domaines, n'oubliez pas de les y rajouter aussi:

::1    ynh.wsl subdomain.ynh.wsl localhost

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 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.

astuce

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.

Premier compte utilisateur​

Le premier compte utilisateur est créé Ă  cette Ă©tape. Il vous faudra choisir un nom d'utilisateur et un mot de passe raisonablement complexe. (Nous ne pouvons que souligner l'importance du choix d'un mot de passe robuste !) Ce compte utilisateur sera ajoutĂ© au groupe Admins, et pourra se connecter au portail utilisateur, Ă  la webadmin, et se connecter via SSH ou SFTP. Les admins recevront aussi les mails envoyĂ©s Ă  root@votredomaine.tld et admin@votredomaine.tld : ces emails peuvent ĂȘtre utilisĂ©s pour envoyer des informations ou des alertes techniques. Vous pourrez plus tard ajouter d'autres comptes utilisateur supplĂ©mentaire, qu'il est aussi possible d'ajouter au groupe Admins.

Ce compte remplace l'ancien compte admin, qui est peut ĂȘtre toujours mentionnĂ© dans certaines pages de documentation. Dans ce cas, remplacez simplement admin par votre identifiant.

Lancer le diagnostic​

Une fois la postinstall terminée, vous devriez pouvoir vous connecter à la webadmin en utilisant les identiants du premier compte utilisateur que vous venez de créer.

Le systÚme de diagnostic est conçu pour fournir un moyen facile de valider que tous les aspects critiques de votre serveur sont proprement configurés et pour vous guider dans la résolution des problÚmes soulevés. Le diagnostic se lance deux fois par jour et envoie une alerte si un dysfonctionnement est détecté.

astuce

N.B. : ne partez pas en courant ! La premiÚre fois que vous lancerez le diagnostic, il est assez normal d'avoir plusieurs alertes rouges ou jaunes car vous devez généralement configurer les enregistrements DNS (si vous n'utilisez pas un domaine .nohost.me, .noho.st ou .ynh.fr), ajouter un fichier de swap ainsi que configurer la redirection des ports sur votre box.

astuce

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 « À ignorer » en allant dans l'administration web > Diagnostic, et en cliquant sur le bouton « Ignorer » pour ce dysfonctionnement spĂ©cifique.

attention

Notamment, les installations WSL ou sur machines virtuelles ne seront généralement pas accessibles de l'extérieur sans une configuration réseau avancée sur Virtualbox et son hÎte.

Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagnostic. Vous devriez obtenir un écran comme celui-ci :

Capture d'écran du panneau de diagnostic
Capture d'écran du panneau de diagnostic

Obtenir un certificat Let's Encrypt​

Une fois que vous avez configurĂ©, si nĂ©cessaire, les enregistrements DNS et la redirection de ports, vous devriez ĂȘtre en mesure d'installer un certificat Let's Encrypt. Ceci permettra de supprimer l'Ă©trange alerte de sĂ©curitĂ© vue plus tĂŽt.

Pour plus d'instructions détaillées, ou pour en savoir plus à propos des certificats SSL/TLS, voir la page correspondante ici.

Capture d'écran du panneau pour installer un certificat Let's Encrypt
Capture d'écran du panneau pour installer un certificat Let's Encrypt

🎉 FĂ©licitations !​

Vous avez maintenant un serveur plutĂŽt bien configurĂ©. Si vous dĂ©couvrez YunoHost, nous vous recommandons de jeter un Ɠil Ă  la visite guidĂ©e. Vous devriez aussi ĂȘtre en mesure d'installer vos applications favorites. N'oubliez pas de prĂ©voir des sauvegardes !