diff --git a/diagnostic.md b/diagnostic.md new file mode 100644 index 00000000..525c5619 --- /dev/null +++ b/diagnostic.md @@ -0,0 +1,52 @@ +# Diagnose YunoHost functioning + +If you have successfully [installed](/install) YunoHost and passed through the [post-installation](/postinstall), you probably have a **working server**. + +## 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... + +### 1. 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](/dns). + +--- + +### 2. Do network ports are 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 outside of your local network, 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. +

+
+ +--- + +### 3. 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. + +You cannot avoid that in a simple way. If you know how to do it, juste configure the `/etc/hosts` of your local clients to access your server with the local IP. Else, retry the installation with a **.nohost.me** or **.noho.st** domain. +