Skip to main content
YunoHost 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.
Prerequisites
  • A plan with at least 1 vCPU, 2 GB of RAM and 20 GB of storage
  • No licence: YunoHost is free software

​
Order

1

Pick the plan

Pick a plan on the YunoHost VPS page: YunoHost is already selected in the order.
2

Check the installation

At the What do you want to install? step, YunoHost is shown on its own. Debian 13 is chosen automatically.
3

Order

The server is created, then YunoHost installs itself in ten to twenty minutes.
You can also install YunoHost on an existing VPS by reinstalling it.

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

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

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

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

​
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 covers the catalogue, the domains and the users in detail.

​
Firewall

If you enable your 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 lists them.

​
Troubleshooting

Contact 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.
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.
Check that the domain resolves to the server IP address. A DNS change can take a few minutes to propagate.