From b56e5b6766e4a8a970e8c5fd7ef549cb1573405c Mon Sep 17 00:00:00 2001
From: Jeff Malnick <malnick@gmail.com>
Date: Tue, 15 Sep 2020 08:50:06 -0700
Subject: [PATCH] docs: add getting started docs for development mode (#359)

---
 website/data/docs-navigation.js              |  2 +-
 website/pages/docs/installing/dev-mode.mdx   | 68 ++++++++++++++++++++
 website/pages/docs/installing/index.mdx      |  2 +-
 website/pages/docs/installing/installing.mdx |  9 ---
 4 files changed, 70 insertions(+), 11 deletions(-)
 create mode 100644 website/pages/docs/installing/dev-mode.mdx
 delete mode 100644 website/pages/docs/installing/installing.mdx

diff --git a/website/data/docs-navigation.js b/website/data/docs-navigation.js
index e85a6e8147..55bc3ded28 100644
--- a/website/data/docs-navigation.js
+++ b/website/data/docs-navigation.js
@@ -36,7 +36,7 @@ export default [
   },
   {
     category: 'installing',
-    content: ['installing'],
+    content: ['dev-mode'],
   },
   {
     category: 'admin-console',
diff --git a/website/pages/docs/installing/dev-mode.mdx b/website/pages/docs/installing/dev-mode.mdx
new file mode 100644
index 0000000000..e368ad545a
--- /dev/null
+++ b/website/pages/docs/installing/dev-mode.mdx
@@ -0,0 +1,68 @@
+---
+layout: docs
+page_title: Development Mode
+sidebar_title: Dev Mode
+description: |-
+  How to install Boundary in development mode
+---
+
+# Development Mode
+
+Dev mode is an all-in-one installation method for getting started with Boundary quickly. As the name implies,
+dev mode is not a production installation method, but instead a way to get Boundary running with a Postgres
+database easily. Do not use dev mode in a production environment, see our "Production Installation" section for
+production ready deployment methods.
+
+Dev mode brings up a fully functioning instance of Boundary, including:
+
+1. A controller server
+2. A worker server
+3. A Postgres database
+
+These components should all be considered ephemeral - no data persistence occurs across dev mode restarts. It's
+strongly recommended that users leverage our [Terraform Provider for Boundary](https://github.com/hashicorp/terraform-provider-boundary) for managing configuration
+of Boundary. This will simplify starting up and shutting down your Boundary dev instance.
+
+## Assumptions
+
+There are a few requirements for running dev mode:
+
+1. Docker is installed
+2. A route to download the [Postgres Docker image](https://hub.docker.com/_/postgres) is available or a local image cache is available
+
+## Run
+
+To start Boundary in dev mode:
+
+```bash
+./boundary dev
+```
+
+The above is the most simple way to start the Boundary server in dev mode. However, there are likely some overrides you'll want to configure when
+doing so, these include:
+
+1. Auth method ID
+2. Auth method password
+3. Account login name
+
+To use these overrides, set the following flags:
+
+```bash
+./boundary dev -dev-auth-method-id=ampw_0000000000 -dev-password=foofoofoo -dev-login-name=foo
+```
+
+Setting these allows you to configure hardcoded auth method ID, password, and login name. You can then use these hardcoded values when configuring clients
+such as the Terraform Provider, or when logging into the admin console.
+
+An example using these values to configure your Terraform provider instance for Boundary:
+
+```hcl
+ provider "boundary" {
+    base_url             = "http://127.0.0.1:9200"
+    auth_method_id       = "ampw_0000000000"
+    auth_method_username = "foo"
+    auth_method_password = "foofoofoo"
+}
+```
+
+Note in the example above we're setting `base_url` to `http` and not `https` as the Boundary server does not use TLS in development mode.
diff --git a/website/pages/docs/installing/index.mdx b/website/pages/docs/installing/index.mdx
index ff0401e77b..233d533277 100644
--- a/website/pages/docs/installing/index.mdx
+++ b/website/pages/docs/installing/index.mdx
@@ -8,4 +8,4 @@ description: |-
 
 # Overview
 
-Installing Boundary is easy!
+This section covers installing Boundary for development and production modes of operation.
diff --git a/website/pages/docs/installing/installing.mdx b/website/pages/docs/installing/installing.mdx
deleted file mode 100644
index e2894a1e6b..0000000000
--- a/website/pages/docs/installing/installing.mdx
+++ /dev/null
@@ -1,9 +0,0 @@
----
-layout: docs
-page_title: Installing Boundary
-sidebar_title: Installing
-description: |-
-  How to install Boundary
----
-
-# How to install Boundary