YunoHost is a server management system based on Linux Debian distribution. The main goal of it is to provide self-hosting to as many people as possible while retaining quality and reliability. The difference from other hosting solutions, YunoHost is not meant to be used in multi-user environments.
1. Installation Guide
1.1. Run Installation Command
You can easily install YunoHost on our servers with Debian 12. Login to your server through SSH and execute the command:
curl https://install.yunohost.org | bash
1.2. Access YunoHost
Access to YunoHost can be successfully established by using your VPS hostname as URL in any browser:
SSL is not enabled by default in YunoHost, so you will initially see a warning about an insecure connection. Proceed by accepting it, and later you can secure your server by issuing a free Let's Encrypt certificate.
Next, agree with YunoHost Terms of Services:
1.3. Set Main Domain
Next, set the main domain for your server. If you already have a domain pointed to your server's IP address using an A record, select 'I want to add a domain I own' and enter your domain name. Alternatively, you can register a free DynDNS domain provided by YunoHost.
1.4. Create first admin user
On this step you need to create your first admin user. Enter user details and click "Next":
1.5. Login
Now you can log in to your YunoHost by entering your admin user details.
2. Get Started With YunoHost
Once you are connected to the YunoHost, you will see the main menu:
We will describe the main YunoHost features in this section.
2.1. Add more users
To add additional user, click "Users" in the main menu and then "Add a user".
Enter new user details and click "Save".
2.2. Edit existing user
You also can edit existing user - click "Users" in the main menu,then select user you want to edit:
Next, click Edit youruser's account.
Here you will be able to adjust current user's details, change it's password, create additional mail aliases and mail forwarders. After the changes are made, do not forget to Save them
2.3. Add domain
To add multiple domains, get back to the home screen and select tab "Domains".
Adding a new domain follows the same steps as when you added the main domain during installation. You can either use your own domain or choose a free DynDNS domain provided by YunoHost.
2.4. Issue Let's Encrypt certificate
As we mentioned earlier, in YunoHost you can issue Let's Encrypt certificate to secure your connection.
From the main menu, click on "Domains" and choose the domain for which you want to issue a certificate. Then, open the "Certificate" tab.
If your domain doesn’t meet the requirements for issuing a certificate (for example, if it isn’t pointed to your server’s IP), you’ll see warning messages similar to those shown in this screenshot:
In the warning message, you can click the provided link to open the diagnosis page, where you’ll find details on what’s incorrect and instructions on how to fix it.
Once everything is fine, you can click "Install Let's Encrypt certificate" and it will be installed shortly for your selected domain.
2.5. Installing needed applications
Once you will have the user accounts and domains prepared for usage, you can proceed with installation of needed applications. For this, head back to the Home screen and choose tab "Applications".
Then, click on green "Install an app" button in the top right corner.
Next, you can select and install app that you want.
After choosing one or another Application, you will have to provide required information that are related to the specific choice.
After installation will be completed, the application will appear in the "Application" section list.
2.6. Remaining sections of the Panel.
Groups and Permissions:
Here you can organize users into groups and assign permissions for accessing applications or services. Instead of managing access for each user individually, you can grant or restrict access to entire groups, making permission management faster and more efficient.
Updates:
This section helps keep your server secure and up to date. You can check for and apply updates for the YunoHost system itself as well as all installed applications.
Tools:
Widest section of whole menu. Provides multiple tools for server management from Diagnosis on the VPS or it's Firewall configuration, to adminsitrator password change and Shutdown/Reboot of the whole VPS.
Diagnosis.
Runs automated checks on your server to detect configuration issues or errors. It provides warnings and suggestions for fixing problems with DNS, SSL certificates, or system services.
Backup:
Last section of the panel where you can backup your VPS information if you plan on making any changes. After choosing "Local archives" sub-category, as usual - green button on the right that says "New backup" should be your main interest. By pressing it you will be able to select what parts of your VPS you would like to include in the backup. For it's generation press another green button on the bottom that says "Backup".
After backup generation will be completed, the copy will be added in the "Local archives" category. By opening the backup copy, you will see when it was generated, what is included in the backup and the option to restore it (Green "Restore" button). You can either restore a partial backup on your chosen sections or restore all of available sections. After confirming the restoration, you will receive notification, when the process will be completed.
For any in depth information on the YunoHost panel and project, you can check the official documentation.