diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..3ded0199af
--- /dev/null
+++ b/README.md
@@ -0,0 +1,39 @@
+# swarm: docker clustering
+
+## Example usage
+
+```bash
+# create a cluster
+$ swarm create
+6856663cdefdec325839a4b7e1de38e8
+
+# on each of your nodes, start the swarm agent
+$ docker run -d -p 4243:4243 swarm join --token=6856663cdefdec325839a4b7e1de38e8 --addr=<docker_daemon_ip:4243>
+
+# start the manager on any machine or your laptop
+$ docker run -d -p 4243:4243 swarm manage --token=6856663cdefdec325839a4b7e1de38e8 --addr=<ip:4243>
+
+# use the regular docker cli
+$ docker -H <ip:4243> ps 
+$ docker -H <ip:4243> run ... 
+$ docker -H <ip:4243> info
+...
+```
+
+## Creators
+
+**Andrea Luzzardi**
+
+- <http://twitter.com/aluzzardi>
+- <http://github.com/aluzzardi>
+
+**Victor Vieux**
+
+- <http://twitter.com/vieux>
+- <http://github.com/vieux>
+
+## Copyright and license
+
+Code and documentation copyright 2014 Docker, inc. Code released under the Apache 2.0 license.
+Docs released under Creative commons.
+