diff --git a/README.md b/README.md
index 79a2ff4be..5341a70a4 100644
--- a/README.md
+++ b/README.md
@@ -39,7 +39,7 @@ boot2docker, replace localhost with the output of `boot2docker ip`.)
 
 If you have any questions about, feedback for or problem with Scope we invite
 you to:
-- <a href="https://weave-scope-slack.herokuapp.com">join our  public slack channel</a>
+- <a href="https://weave-scope-slack.herokuapp.com">join our public slack channel</a>
 - send an email to <a href="mailto:weave-users@weave.works">weave-users@weave.works</a>
 - <a href="https://github.com/weaveworks/scope/issues/new">file an issue</a>
 
@@ -169,6 +169,45 @@ sudo scope launch --service-token=<token>
 +-----------------------+      +-----------------------+
 ```
 
+## <a name="launching-weave-scope-and-compose-in-cloud-service-mode"></a>Launching Weave Scope and Docker Compose in Cloud Service Mode
+
+In both blocks below, replace MY_SCOPE_SERVICE_TOKEN with the token you find when you [log in to the Scope service](https://scope.weave.works/).
+
+### Docker Compose format version 2:
+
+    version: '2'
+    services:
+      probe:
+        image: weaveworks/scope:0.13.1
+        network_mode: "host"
+        pid: "host"
+        privileged: true
+        labels:
+          - "works.weave.role=system"
+        volumes:
+          - "/var/run/docker.sock:/var/run/docker.sock:rw"
+        command:
+          - "--probe.docker"
+          - "true"
+          - "--service-token"
+          - "MY_SCOPE_SERVICE_TOKEN"
+
+### Docker Compose format version 1:
+
+    probe:
+      image: weaveworks/scope:0.13.1
+      net: "host"
+      pid: "host"
+      privileged: true
+      labels:
+        - "works.weave.role=system"
+      volumes:
+        - "/var/run/docker.sock:/var/run/docker.sock:rw"
+      command:
+        - "--probe.docker"
+        - "true"
+        - "--service-token"
+        - "MY_SCOPE_SERVICE_TOKEN" 
 
 ## <a name="using-weave-scope-with-kubernetes"></a>Using Weave Scope with Kubernetes
 
diff --git a/examples/docker/docker-compose-v1.yml b/examples/docker/docker-compose-v1.yml
new file mode 100644
index 000000000..cead93b2b
--- /dev/null
+++ b/examples/docker/docker-compose-v1.yml
@@ -0,0 +1,14 @@
+probe:
+  image: weaveworks/scope:0.13.1
+  net: "host"
+  pid: "host"
+  privileged: true
+  labels:
+    - "works.weave.role=system"
+  volumes:
+    - "/var/run/docker.sock:/var/run/docker.sock:rw"
+  command:
+    - "--probe.docker"
+    - "true"
+    - "--service-token"
+    - "MY_SCOPE_SERVICE_TOKEN" 
\ No newline at end of file
diff --git a/examples/docker/docker-compose-v2.yml b/examples/docker/docker-compose-v2.yml
new file mode 100644
index 000000000..8123a1dac
--- /dev/null
+++ b/examples/docker/docker-compose-v2.yml
@@ -0,0 +1,16 @@
+version: '2'
+services:
+  probe:
+    image: weaveworks/scope:0.13.1
+    network_mode: "host"
+    pid: "host"
+    privileged: true
+    labels:
+      - "works.weave.role=system"
+    volumes:
+      - "/var/run/docker.sock:/var/run/docker.sock:rw"
+    command:
+      - "--probe.docker"
+      - "true"
+      - "--service-token"
+      - "MY_SCOPE_SERVICE_TOKEN"
\ No newline at end of file