> ## Documentation Index
> Fetch the complete documentation index at: https://help.onetsolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# YunoHost

> Commander un VPS avec YunoHost, terminer la post-installation et installer vos premières applications

[YunoHost](https://yunohost.org) est une distribution d'auto-hébergement éditée par un tiers. Fondée sur Debian, elle installe et gère les applications de son propre catalogue, ainsi que les domaines, les utilisateurs et les e-mails qui vont avec, et ne coûte rien en licences. Sur un VPS OnetSolutions, elle est installée pour vous à la création du serveur.

<Info>
  **Prérequis**

  * Une offre d'au moins 1 vCPU, 2 Go de RAM et 20 Go de stockage
  * Aucune licence : YunoHost est un logiciel libre
</Info>

## Commander

<Steps>
  <Step title="Choisir l'offre">
    Choisissez une offre sur la page [VPS YunoHost](https://onetsolutions.net/vps/yunohost) : YunoHost est déjà sélectionné dans la commande.
  </Step>

  <Step title="Vérifier l'installation">
    À l'étape **Que voulez-vous installer ?**, YunoHost est affiché seul. Debian 13 est choisi automatiquement.
  </Step>

  <Step title="Commander">
    Le serveur est créé, puis YunoHost s'installe en dix à vingt minutes.
  </Step>
</Steps>

Vous pouvez aussi installer YunoHost sur un VPS existant en le [réinstallant](/fr/control-panels/overview#installer-un-panneau-sur-un-vps-existant).

## Première connexion

YunoHost ne génère pas de mot de passe administrateur pendant l'installation : vous terminez une post-installation depuis votre navigateur, où vous choisissez le domaine principal et le mot de passe administrateur.

<Steps>
  <Step title="Ouvrir l'interface d'administration">
    Quand la carte affiche **Installé**, sélectionnez **Ouvrir le panneau**, ou ouvrez `https://<adresse IP du serveur>/yunohost/admin`. Le panneau répond sur le port 443, et non sur un port dédié. Votre navigateur signale un certificat autosigné tant qu'aucun nom de domaine n'est configuré : c'est attendu.
  </Step>

  <Step title="Choisir le domaine principal">
    La post-installation demande le premier domaine du serveur. Utilisez un nom de domaine qui vous appartient et que vous avez fait pointer vers l'adresse IP du serveur par un enregistrement A, ou l'un des sous-domaines gratuits que YunoHost propose à cette étape.
  </Step>

  <Step title="Définir le mot de passe administrateur">
    Toujours dans la post-installation, choisissez le mot de passe administrateur. C'est celui que vous utiliserez ensuite pour vous connecter, et rien d'autre n'est écrit sur le serveur pour vous le rappeler.
  </Step>
</Steps>

<Note>
  La console n'affiche pas d'identifiants pour YunoHost : aucun fichier d'identifiants n'est généré, puisque vous choisissez vous-même le mot de passe pendant la post-installation.
</Note>

## Installer une application

Une fois la post-installation terminée, l'interface d'administration s'ouvre sur le catalogue d'applications de YunoHost : choisissez une application, indiquez le domaine ou le chemin où elle doit répondre, et YunoHost l'installe, avec sa base de données et ses utilisateurs.

La [documentation de YunoHost](https://doc.yunohost.org) détaille le catalogue, les domaines et les utilisateurs.

## Pare-feu

Si vous activez le [pare-feu](/fr/vps/firewall) de votre VPS, autorisez les ports 80 et 443 : l'interface d'administration et vos applications passent tous les deux par eux. Ajoutez les ports de messagerie si vous utilisez le serveur mail de YunoHost, et les ports propres à une application qui en demande. La [documentation de YunoHost](https://doc.yunohost.org) en donne la liste.

## Dépannage

<AccordionGroup>
  <Accordion title="L'installation affiche Échec">
    Contactez le [support](/fr/console/support) depuis la console : nous vous aidons à relancer l'installation. Le détail de l'installation est enregistré sur le serveur, dans `/var/log/onetsolutions-yunohost-install.log`.
  </Accordion>

  <Accordion title="Le panneau ne répond pas sur l'adresse IP">
    Vérifiez que l'état de la carte est bien **Installé**, puis que le port 443 est autorisé si le pare-feu est activé. L'adresse se termine par `/yunohost/admin` : la racine du serveur est servie à vos visiteurs, pas à vous.
  </Accordion>

  <Accordion title="YunoHost refuse le domaine">
    Vérifiez que le domaine pointe bien vers l'adresse IP du serveur. Une modification DNS peut mettre quelques minutes à se propager.
  </Accordion>
</AccordionGroup>