How to Install and Use YunoHost: A Complete Guide

Welcome to the definitive guide for taking back control of your digital life. If you have ever wanted your own private cloud, your own email server, or a personal space to chat and share files without relying on big tech corporations, you are in the right place. This tutorial walks you through setting up YunoHost on a fresh Debian server instance, configuring the essential prerequisites, and getting started with its administrative and user interfaces.

What Is YunoHost?

Imagine walking into a tech store, buying a pile of computer parts, an operating system, a router, a security system, an email handler, and a dozen different software programs, and then trying to wire them all together in your basement. Traditionally, that is what self-hosting felt like. It was powerful, but it was exhausting.

YunoHost is an open-source operating system built on top of Debian Linux that completely changes the rules. Its main goal is to democratize self-hosting by wrapping all that complicated server setup into a clean, friendly, point-and-click web dashboard.

YunoHost Features

• One-Click App Store: YunoHost comes with a massive catalog of open-source applications (like Nextcloud for file sharing, Mastodon for social media, or Vaultwarden for passwords) that install themselves cleanly with minimal effort.
• Unified Single Sign-On (SSO): Instead of logging into twenty different apps with twenty different passwords, your users log in once through a central portal and jump seamlessly between all your services.
• Built-in Security and Maintenance: It automatically handles SSL security certificates (via Let’s Encrypt), sets up firewalls, manages user accounts, and even includes a complete email stack.
• 100% Free and Independent: There are no premium tiers, no hidden subscriptions, and no corporate tracking. Your data stays entirely on your hardware.

Requirements & Before You Begin

Before we install YunoHost, you need to decide where it is going to live and what address it will use on the internet. You can use a local spare desktop computer / Raspberry Pi or a rented Virtual Private Server (VPS) running Debian 11 or higher. A domain name is also highly recommended to configure HTTPS encryption properly.

The installation steps require root administrative privileges. Make sure you are logged in as root.

Step 1: Connect to Your Server

Open your terminal application on your desktop and log into your server via SSH:

ssh root@<your-server-ip-address>

Step 2: Configure the Firewall

Make sure your system allows safe web traffic through the door. Run this command to open the secure web port and reload UFW:

ufw allow https
ufw reload

Step 3: Run the Automatic Installer

Tell your server to grab the necessary helper tools (curl and certificate bundles) and launch the official YunoHost installation script:

apt install curl ca-certificates
curl https://install.yunohost.org | bash

Note: The script may ask if you want to overwrite certain configuration files or tweak SSH settings. When in doubt, accept the default suggestions (usually answering Yes to file updates and No to direct SSH modifications).

Step 4: Running the Post-Installation Setup

The post-installation phase is where your server gets its identity: your domain name and your main administrator password. You can do this directly from your terminal by running:

yunohost tools postinstall

Follow the interactive prompts on your screen to specify your domain name and administration password. For future command-line logins, use the newly minted admin account instead of raw root access (e.g., ssh admin@<your-server-ip>).

Step 5: Logging Into Your Admin Dashboard

Open your web browser, type your server's IP address or domain name followed by /yunohost/admin:

https://<your-server-ip-or-domain>/yunohost/admin

Log in using your administrator password. Next, upgrade to a free Let’s Encrypt SSL certificate by going to Domains > Your Domain > Certificate > Install Let’s Encrypt certificate.

Create your first regular user under the Users section to enable application deployment and automated email accounts.

Step 6: Installing an Application

Navigate to the Applications page from your dashboard, click + Install, and choose a well-integrated tool (such as Mastodon or Nextcloud) with a few clicks.

Step 7: Using the User Portal

Access your centralized single sign-on (SSO) hub by navigating to:

https://<your-server-ip-or-domain>/yunohost/sso

Log in with your standard user credentials to see your application gallery and access all installed services seamlessly.