Support Online
MirrorLooking Glass
GenixNodeGenixNode
Client Panel
Skip to main content

Installing YunoHost on Debian 9

What will you learn in this guide?​

YunoHost is an open source platform that allows you to host applications such as WordPress, webmail clients, and password managers on your own server.
In this guide, you will install YunoHost on your Debian 9 virtual server, configure DNS records, provide HTTPS security with Let's Encrypt and easily manage applications.

Technical Summary​

Main Topic:
YunoHost installation and configuration on Debian 9.

Solved Problem:
Simplifying the complex installation and management processes of self-hosted applications.

Steps Followed:
Setup → DNS configuration → SSL security → user and application setup.

Prerequisites​

  • Virtual server with Debian 9 installed
  • At least 1 GB RAM
  • User with authority sudo
  • Firewall configured system
  • Domain name pointed to server IP (example: ornek.com)

YunoHost Installation​

YunoHost can be quickly installed with the official installation script.

1. Change to temporary directory:

cd /tmp
  • Installation files are kept in the temporary directory.

2. Download the installation script:


wget -O yunohost https://install.yunohost.org/
  • The official YunoHost installation script is downloaded.

3. Run the script:


sudo /bin/bash yunohost
  • All necessary packages and services are installed.
  • Select Yes when asked for configuration files. On the post-installation screen, select Yes to continue.
  1. Set the main domain name and administrator password.

Configuring DNS Records​

  1. Open your domain or server IP from the browser.

  2. Continue past the self-signed certificate warning.

  3. Log in to YunoHost panel with the administrator password. 4. Go to Domains → DNS configuration.

  • YunoHost shows all the necessary DNS records with a sample zone file.

DigitalOcean DNS Records​

A Records​

  1. @ → Server IP

    • → Server IP
SRV Records​

  1. _xmpp-client._tcp → Port 5222

  2. _xmpp-server._tcp → Port 5269

CNAME Records​

  1. muc → @

  2. pubsub → @

  3. vjud → @

Email Records​

  1. MX → @, Priority 10

  2. TXT → SPF, DKIM, DMARC (must be copied verbatim from the sample file)

CAA Registration​

  1. Host: @

  2. Tag: issue

3.Flags: 128

  1. Authority: letsencrypt.org

DNS propagation may take several minutes.

Let's Encrypt Certificate Installation​

Follow the path Domains → Operations → SSL certificates. Select Install a Let's Encrypt certificate.

  • The certificate is automatically installed and renewed.

User and Application Setup​

1. Creating User Add a new user from Users → New user section.

  • An automatic e-mail account is defined for each user created.

3. Application Setup (Rainloop Example)

  • Select the Rainloop application from the Applications section.

During configuration:

  1. Domain name

  2. URL path (/rainloop)

  3. Access authorization

  4. Administrator password

  5. Enter the information and press the Install button.

You can access the application at:


https://alanadiniz/rainloop

Frequently Asked Questions (FAQ)​

1. Why does YunoHost require so many DNS records? Because email, XMPP and web services run under the same domain.

2. Is the self-signed warning permanent? No. Once installed, Let's Encrypt is completely removed.

3. Can a custom application be added? Yes. Third party applications can be installed via GitHub.

4. What happens if the administrator password is forgotten? It can be reset with the yunohost CLI from the server console.

Result​

With this guide, you have set up a fully featured YunoHost platform on Debian 9. You can now manage your e-mail and web applications from a single panel.

By implementing this setup on GenixNode virtual servers, you can gain full control over your data.