diff --git a/examples/torrent/README.md b/examples/torrent/README.md
new file mode 100644
index 0000000..5eadad5
--- /dev/null
+++ b/examples/torrent/README.md
@@ -0,0 +1,21 @@
+Example of using torrent transport with solar. Torrent is used to distribute task data. After fetching is finished torrent client forks and continues seeding.
+
+
+The example contains single node with single host mapping + transports.
+
+Execute:
+```
+python examples/torrent/example.py
+solar changes stage
+solar changes process
+solar orch run-once last
+```
+
+Wait for finish:
+
+```
+solar orch report last -w 100
+```
+
+After this you should see new entry in `/etc/hosts` file.
+
diff --git a/examples/torrent/example.py b/examples/torrent/example.py
index 21dd102..6d8dabc 100644
--- a/examples/torrent/example.py
+++ b/examples/torrent/example.py
@@ -1,11 +1,3 @@
-# To run:
-# python example-riaks.py deploy
-# python example-riaks.py add_haproxies
-# solar changes stage
-# solar changes process
-# solar orch run-once last
-
-
 import time
 
 from solar.core.resource import virtual_resource as vr