diff --git a/docs/tutorials/retroshare.md b/docs/tutorials/retroshare.md
index 49830c5..1655880 100644
--- a/docs/tutorials/retroshare.md
+++ b/docs/tutorials/retroshare.md
@@ -1,21 +1,27 @@
 Using RetroShare with i2pd
 ==========================
 
+RetroShare is a rich set of P2P applications, which can work on top of anonymous I2P network.
+Quoting [Wikipedia](https://en.wikipedia.org/wiki/RetroShare):
 
-Retroshare is I2P capable.  
-Their [configuration instructions](https://retroshare.readthedocs.io/en/latest/tutorial/i2p-hidden-rs-node/) for Java I2P.
-In order to do it for i2pd, you must create a new server tunnels in tunnels.conf like this  
+> RetroShare is open source software for encrypted filesharing, serverless email, instant messaging, online chat, and BBS, based on a friend-to-friend network built on GNU Privacy Guard (GPG).
 
-[Retroshare]  
-type=server  
-host=127.0.0.1  
-port="port you wish to use"  
-keys=retroshare.dat  
+In order to make RetroShare work with i2pd, you need to create a new server tunnel in [tunnels.conf](../user-guide/tunnels.md) like this: 
 
-You can specify [more options](https://github.com/PurpleI2P/i2pd/wiki/tunnels.conf)  
-Also keep SOCKS proxy enabled. It's enabled by default.
+    [retroshare]  
+    type=server  
+    host=127.0.0.1  
+    port=10123            # pick random port of your choice 
+    keys=retroshare.dat  
 
-Start i2pd with this new tunnels, and get it's .b32.i2p address from http://127.0.0.1:7070/?page=i2p_tunnels.
-Now you are ready to create hidden profile for Retroshare.
-Mark it as hidden and enter your .b32.i2p and port you specified for tunnel.
+Make sure that Socks proxy is enabled, it listens at ``127.0.0.1:4447`` by default. If not, look at [i2pd.conf documentation](../user-guide/configuration.md).
 
+Restart i2pd with new configuration. 
+
+Find .b32.i2p address of your RetroShare node.
+Go to webconsole -> [I2P tunnels page](http://127.0.0.1:7070/?page=i2p_tunnels). Look for Sever tunnels and you will see address like \<long random string\>.b32.i2p next to "retroshare".
+
+Now when everything is prepared, you can run RetroShare itself and create a new profile.
+Mark it as **hidden** and enter your **.b32.i2p address** and **port** you have specified at tunnels.conf.
+
+More information about RetroShare at their [website](http://retroshare.net).