There are several reasons that could lead to one administrator's access being partially or completely blocked off their YunoHost server. In numerous cases, one of the access methods is blocked, but others are not.
This page will help you diagnose the issue, get back access, and if needed repair your system. Most common causes are listed first, so follow the tutorial from top to bottom.
Check that you are getting access to the server by using its public IP (you can find at https://ip.yunohost.org. If this does not work:
hostsfile on your computer to make it bind your domain name to the local IP address instead of the public one.
This is not a problem if you are using a domain from
You have to configure your DNS records (at least
A records, and
AAAA if you have an IPv6 connection).
ynh.fris unreachable following a failure on YunoHost's infrastructure. Check the forum for announcements or people posting about the same issue.
ynh.frthat includes this features.
A certificate error may be displayed if you have made a typo in the address bar of your browser.
If you have just installed your server, or just installed a new domain, it uses a self-signed certificate. In that case, it is possible and understandable to add a temporary security exception so that you can install a Let's Encrypt certificate, provided you have a secure Internet connection.
By default, SSH connection has to be made as
admin. It possible to log into the server as
root only from the local network of the server. If your server is a VPS, the web console or VNC provided by VPS providers may work.
If you are running
yunohost commands in the CLI as
admin, you have to call them with
sudo before (for example
sudo yunohost user list). You can also become
root by running
Your YunoHost server includes a service, Fail2ban, which automatically bans IPs that fail several times in a row to log in. In some cases it can be software (e.g. Nextcloud client) that are confifured with an old password, or a user who has the same IP as you have.
If you have been banned while trying to access a web page, and only web pages are unreachable, you may have access to your server via SSH. Similarly, if you have been banned from SSH, webadmin access may work.
If you have been banned from both SSH and webadmin, you can try to reach your server through another IP address. For example through the cellular network of your phone, a VPN, Tor, or another proxy.
See also : unban an IP on Fail2Ban
Ban are usually 10 to 12-minute-long, and on IPv4 only.
Maybe the NGINX web server is out of order. You can check that trough SSH with the command
yunohost service status nginx. If it is failing, check that its configuration is correct by running
nginx -t. If it is indeed broken, it may be due to the installation or removal of a low-quality app... If you need support, ask for it.
The NGINX or SSH servers may have been killed due to a lack of storage space, RAM, or swap.
systemctl restart nginx.
df -h. If one of your partitions is full, you need to identify what fills it and make room. You can use
ncducommand (install it with
apt install ncduto browse from the root directory:
free -h. Depending on the result, it may be necessary to optimize your server to use less RAM (removal of heavy or unused apps...), add more RAM or add a swap file.
You can check that by
ping -4 yourdomain.tld # or its IPv4 ping -6 yourdomain.tld # or its IPv6
If one of the two is working, use it to connect by SSH or the webadmin.
If none are working, you need to resolv your connection issue. In some cases, an update of your router may have enabled IPv6 and DNS configuration may be disrupted.
It is highly probable that the underlying service for these apps is failing (e.g. PHP apps requiring
php7.3-fpm). You can then try to restart the services, and/or ask for help
If you can reach the webadmin login page (force reload with
CTRL + F5 to be sure), and you cannot log in, your password is probably wrong.
If yoy are sure of your passord, it may be due to the
slapd service failing. If that's the case, log into the server by SSH as
Once logged in, you have to check the state of the service with
yunohost service status slapd and/or reset your admin password with
yunohost tools adminpw.
If this is still failing, on a VPS you may be able to reboot in rescue mode. Do not hesitate to ask for help
To be completed.
If you have a VPN with fixed IP, maybe it has expired, or the provider's infrastructure is failing.
In that case, contact your VPN provider to renew it and update the parameters of the VPN Client app.
Meanwhile, try reaching your server if it is at home, by:
sudo arp-scan --local
yunohost-2.local, etc. depending on how many YunoHost servers are on your network.
To be completed.
In some cases your server may be stuck at boot. It may come from a new, buggy, kernel. Try changing to another kernel on the boot screen (via VNC for VPS).
If you are in "rescue" mode with
grub, it may be due a misconfiguration of
grub, or a corrupted drive.
In that case, access the storage drive from another system (your provider's "rescue" mode, live USB drive, read the SD or drive on another computer) and try to check partitions integrity with
If disks are corrupted or hard to mount, you have to save your data and maybe reformat, reinstall, and/or change the drive. If you succeed in mounting the drive, you can use
systemd-nspawn to access its database.
grub-install again with
chroot or with
It may be due hardware issue on your server, or with the hypervisor if it is on a VPS.
If you are renting your server, contact the support of your provider. Otherwise, try fixing your machine by replacing failing components.
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to suggest changes.