doc/diagnostic.md
2016-11-09 14:58:34 +01:00

2.5 KiB

Diagnose YunoHost functioning

If you have successfully installed YunoHost and passed through the post-installation, you probably have a working server.

1. Test it

In a web browser, access to your server via the domain name you just entered at the post-installation step.

For example: http://mydomain.com

If you have taken a .nohost.me or a .noho.st domain, you may have to wait 5 min before the address is reachable.

If that does not work...


2. Have you configured your DNS well ?

This step is not necessary if you have a .nohost.me or a .noho.st domain

Go to https://www.whatsmydns.net/ , enter your domain name in the field and click Search.
If you do not see your IP address, or if there is red crosses everywhere, then you have probably misconfigured your DNS.


3. Are network ports opened on your router ?

If your DNS is well configured, and your server looks is accessible locally, you may have network ports blocked or not forwarded by your router.
In order to verify that, try accessing your server with a client outside your local network. For example via another WiFi access point or with your mobile phone in 3G/4G.

If the server is unreachable from outside your local network too, then the problem probably comes from your router's configuration.

Try to activate uPnP in your router's configuration interface, and check that your server is plugged in Ethernet directly behind it.

You can also redirect ports manually to your server's local IP address on this router's configuration interface.


4. Do your router has hairpinning ?

If the server is accessible from outside your local network, but unreachable with its domain name on the local network, then your router probably lacks of hairpinning.

Here is a tutorial to access to your server on a local network and bypass hairpinning problem. The tutorial propose in first solution to create a redirection with DNS of the ISP box and on second solution to modify hosts file of clients to say to access the server via it's local IP address. First solution is preferable because it's not needed to modify hosts files on every computer of the local network, if using many clients.