diff --git a/README.md b/README.md
index 0f87a8ba13..7d4cda7402 100644
--- a/README.md
+++ b/README.md
@@ -10,10 +10,51 @@ Cumulus clouds are shaped sort of like dots and are up in the air, like this pro
 
 For now, this is only project contained in this repo. *cumulus-consensus* is a consensus engine for Substrate which follows a Polkadot relay chain. This will run a Polkadot node internally, and dictate to the client and synchronization algorithms which chain to follow, finalize, and treat as best.
 
-## cumulus-runtime 
+## cumulus-runtime
 
 A planned wrapper around substrate runtimes to turn them into parachain validation code and to provide proof-generation routines.
 
 ## cumulus-collator
 
-A planned Polkadot collator for the parachain.
\ No newline at end of file
+A planned Polkadot collator for the parachain.
+
+## Running a collator
+
+1. Checkout polkadot at `bkchr-cumulus-branch`.
+2. Build the polkadot chainspec:
+
+	`cargo run --release -- build-spec --chain=local --raw > polkadot_chainspec.json`
+
+	Open the `polkadot_chainspec.json` and replace the `bootnodes` with: `"bootNodes": [],`
+
+3. Run `Alice` and `Bob`:
+
+	`cargo run --release -- --chain=local --base-path=cumulus_relay_chain_node_0 --alice`
+
+	`cargo run --release -- --chain=local --base-path=cumulus_relay_chain_node_1 --bob --port 50666`
+
+3. Switch back to this repository and generate the parachain genesis state:
+
+	`cargo run --release -p cumulus-test-parachain-collator -- export-genesis-state genesis-state`
+
+4. Run the collator:
+
+	`cargo run --release -p cumulus-test-parachain-collator -- -d cumulus_collator_path --chain polkadot_chainspec.json --bootnodes /ip4/127.0.0.1/tcp/30333/p2p/PEER_ID`
+
+	`PEER_ID` needs to be replaced with the peer id of the polkadot validator that uses `Alice`
+	as authority.
+
+5. Open `https://polkadot.js.org/apps/#/sudo` and register the parachain.
+
+	`id`: `100`
+
+	`initial_head_data`: Use the file you generated in 3. (name: genesis-state)
+
+	`code`: `CUMULUS_REPO/target/release/wbuild/cumulus-test-parachain-runtime/cumulus_test_parachain_runtime.compact.wasm`
+
+	Now your parachain should be registered and the collator should start building blocks and sending
+	them to the relay chain.
+
+6. ...
+
+7. PROFIT!