diff --git a/README.md b/README.md
index a9a2a22..6199ae4 100644
--- a/README.md
+++ b/README.md
@@ -22,3 +22,31 @@
 ```
 
 To submit changes to this repository, see http://golang.org/doc/contribute.html.
+
+# deployment
+
+## managed-vms
+
+```
+boot2docker shellinit
+gcloud preview app setup-managed-vms
+gcloud preview app run app/ sandbox/
+gcloud preview app deploy app/ sandbox/
+```
+
+## kubernetes
+
+```
+# sandbox
+docker push golang/playground-sandbox
+gcloud preview container replicationcontrollers create --config sandbox/kubernetes/controller.yaml
+gcloud preview container services create --config sandbox/kubernetes/service.yaml
+```
+
+## container-vm
+
+```
+# sandbox
+docker push golang/playground-sandbox
+gcloud compute instances create playground-sandbox-vm --image container-vm --metadata-from-file google-container-manifest=sandbox/container-vm.yaml
+```
diff --git a/sandbox/container-vm.yaml b/sandbox/container-vm.yaml
new file mode 100644
index 0000000..3bd498f
--- /dev/null
+++ b/sandbox/container-vm.yaml
@@ -0,0 +1,8 @@
+version: v1beta2
+containers:
+  - name: sandbox
+    # TODO(proppy): publish the sandbox image to the hub
+    image: golang/playground-sandbox
+    ports:
+      - containerPort: 8080
+        hostPort: 80
diff --git a/sandbox/kubernetes/controller.yaml b/sandbox/kubernetes/controller.yaml
new file mode 100644
index 0000000..72bbb07
--- /dev/null
+++ b/sandbox/kubernetes/controller.yaml
@@ -0,0 +1,20 @@
+id: sandbox-controller
+kind: ReplicationController
+apiVersion: v1beta1
+desiredState:
+  replicas: 5
+  replicaSelector:
+    name: sandbox
+  podTemplate:
+    desiredState:
+      manifest:
+        version: v1beta2
+        containers:
+        - name: sandbox
+          # TODO(proppy): publish the sandbox image to the hub
+          image: golang/playground-sandbox
+          ports:
+          - name: sandbox-server
+            containerPort: 8080
+    labels:
+      name: sandbox
\ No newline at end of file
diff --git a/sandbox/kubernetes/service.yaml b/sandbox/kubernetes/service.yaml
new file mode 100644
index 0000000..7b74c38
--- /dev/null
+++ b/sandbox/kubernetes/service.yaml
@@ -0,0 +1,7 @@
+id: sandbox-service
+kind: Service
+apiVersion: v1beta1
+port: 8080
+containerPort: sandbox-server
+selector:
+  name: sandbox