diff --git a/CODE_OF_CONDUCT.md b/code_of_conduct.md
similarity index 100%
rename from CODE_OF_CONDUCT.md
rename to code_of_conduct.md
diff --git a/CONTRIBUTING.md b/contributing.md
similarity index 100%
rename from CONTRIBUTING.md
rename to contributing.md
diff --git a/packages/my-joy-instances/src/state/apollo-client.js b/packages/my-joy-instances/src/state/apollo-client.js
index d8065366..b0567528 100644
--- a/packages/my-joy-instances/src/state/apollo-client.js
+++ b/packages/my-joy-instances/src/state/apollo-client.js
@@ -28,7 +28,10 @@ export default (opts = {}) => {
       credentials: 'same-origin',
       fetch,
       headers: {
-        'X-CSRF-Token': global.cookie.replace(/(?:(?:^|.*;\s*)crumb\s*=\s*([^;]*).*$)|^.*$/, '$1')
+        'X-CSRF-Token': global.cookie.replace(
+          /(?:(?:^|.*;\s*)crumb\s*=\s*([^;]*).*$)|^.*$/,
+          '$1'
+        )
       }
     }),
     ...opts
diff --git a/running.md b/running.md
new file mode 100644
index 00000000..77123625
--- /dev/null
+++ b/running.md
@@ -0,0 +1,36 @@
+# How to run the Joyent Portal
+
+#### Requisites 
+
+ - [ ] [Install node.js](https://nodejs.org/en/download/current/)
+ - [ ] [Install Yarn](https://yarnpkg.com/en/docs/install)
+ - [ ] [Setup node-triton](https://github.com/joyent/node-triton#setup)
+ 
+## via [webconsole-instances](https://github.com/joyent/webconsole-instances)
+
+[webconsole-instances](https://github.com/joyent/webconsole-instances) is the stable version of the portal. It gets updated with stable releases from [joyent-portal](http://github.com/yldio/joyent-portal). 
+
+```
+➜ git clone https://github.com/joyent/webconsole-instances
+➜ cd webconsole-instances
+➜ yarn
+➜ ./gen-keys.sh
+➜ ./setup.sh # use instructions from previous step
+➜ sed -i -e 's/production/development/g' _env
+➜ docker-compose -f local-compose.yml up
+➜ # visit http://localhost:80
+```
+
+## via [joyent-portal](http://github.com/yldio/joyent-portal)
+
+[joyent-portal](http://github.com/yldio/joyent-portal) is the unstable and in-development version of the portal. It may be broken at any point in time.
+
+```
+➜ git clone https://github.com/yldio/joyent-portal
+➜ cd joyent-portal
+➜ yarn
+➜ yarn run build:bundle
+➜ cd bundle
+➜ eval "$(triton env <your profile>)"
+➜ yarn run start
+```