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

> Order a VPS with YunoHost, complete the post-installation and install your first applications

[YunoHost](https://yunohost.org) is a self-hosting distribution published by a third party. Built on Debian, it installs and manages applications from its own catalogue, along with the domains, users and email that go with them, and costs nothing in licences. On an OnetSolutions VPS, it is installed for you when the server is created.

<Info>
  **Prerequisites**

  * A plan with at least 1 vCPU, 2 GB of RAM and 20 GB of storage
  * No licence: YunoHost is free software
</Info>

## Order

<Steps>
  <Step title="Pick the plan">
    Pick a plan on the [YunoHost VPS](https://onetsolutions.net/en/vps/yunohost) page: YunoHost is already selected in the order.
  </Step>

  <Step title="Check the installation">
    At the **What do you want to install?** step, YunoHost is shown on its own. Debian 13 is chosen automatically.
  </Step>

  <Step title="Order">
    The server is created, then YunoHost installs itself in ten to twenty minutes.
  </Step>
</Steps>

You can also install YunoHost on an existing VPS by [reinstalling it](/control-panels/overview#install-a-panel-on-an-existing-vps).

## First sign-in

YunoHost does not generate an administrator password during the installation: you complete a post-installation step in your browser, where you choose the main domain and the administrator password.

<Steps>
  <Step title="Open the administration interface">
    When the card shows **Installed**, select **Open the panel**, or open `https://<server IP address>/yunohost/admin`. The panel answers on port 443, not on a dedicated port. Your browser warns about a self-signed certificate until a domain name is configured: this is expected.
  </Step>

  <Step title="Choose the main domain">
    The post-installation asks for the first domain of the server. Use a domain name you own and have pointed to the server IP address with an A record, or one of the free subdomains YunoHost offers at this step.
  </Step>

  <Step title="Set the administrator password">
    Still in the post-installation, choose the administrator password. It is the one you will use to sign in afterwards, and nothing else is written on the server for you to read.
  </Step>
</Steps>

<Note>
  The console does not show credentials for YunoHost: there is no generated credentials file, since you pick the password yourself during the post-installation.
</Note>

## Install an application

Once the post-installation is done, the administration interface opens on the YunoHost application catalogue: pick an application, give it the domain or the path where it should answer, and YunoHost installs it, along with its database and its users.

The [YunoHost documentation](https://doc.yunohost.org) covers the catalogue, the domains and the users in detail.

## Firewall

If you enable your VPS [firewall](/vps/firewall), allow ports 80 and 443: the administration interface and your applications both go through them. Add the email ports if you use the YunoHost mail server, and the ports of any application that needs its own. The [YunoHost documentation](https://doc.yunohost.org) lists them.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The installation shows Failed">
    Contact [support](/console/support) from the console: we will help you run the installation again. The installation details are logged on the server, in `/var/log/onetsolutions-yunohost-install.log`.
  </Accordion>

  <Accordion title="The panel does not answer on the IP address">
    Check that the card status is **Installed**, then that port 443 is allowed if the firewall is enabled. The address ends with `/yunohost/admin`: the root of the server is served to your visitors, not to you.
  </Accordion>

  <Accordion title="YunoHost refuses the domain">
    Check that the domain resolves to the server IP address. A DNS change can take a few minutes to propagate.
  </Accordion>
</AccordionGroup>