2.5 KiB
Configure port-forwarding
If you are self-hosting at home and without a VPN, you need to forward ports on your home router ("Internet box"). If you want a short explanation on what is and why you need port forwarding, have a look in this page.
0. Diagnose ports opened
After configuring port forwarding, you should be able to validate with this small tool that your ports are correctly forwarded :
Check which ports are forwarded
1. Access your box/router administration interface
Your box/router admin interface is usually reachable via http://192.168.0.1 or http://192.168.1.1. Then, you will probably need to authenticate yourself with your internet server provider's credentials.
2. Find the local IP of your server
Identify what is the local IP of your server, either :
- from your box/router interface, which might list devices connected
- from the YunoHost webadmin, in 'State of the server', 'Network'
- from the command line in your server, by running
ip a | grep "scope global" | awk '{print $2}'
A local IP address typically looks like 192.168.xx.yy, or 10.0.xx.yy.
3. Forwarding ports
In your router admin interface, look for something like 'router configuration' or 'port forwarding'. The naming differs among the various kinds of boxes.
Opening the ports listed below is necessary for the various services available in YunoHost to work. For each of them, the 'TCP' forwarding is needed. Some interfaces refer to 'external' and 'internal' ports : these are the same in our case.
- Web: 80 (HTTP), 443 (HTTPS)
- SSH: 22
- XMPP: 5222 (clients), 5269 (servers)
- Email: 25, 587 (SMTP), 993 (IMAP)
Automatic port forwarding / UPnP
A technology called UPnP is available on some internet boxes / routers and allows to automatically forward ports by the machine who needs them. If UPnP is enabled in your local network, then running this command should automatically open the port for you :
sudo yunohost firewall reload