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.
+