coder
diff --git a/‎assets/setup/docker-desktop-resources.png
162 KB b/‎assets/setup/docker-desktop-resources.png
162 KB
diff --git a/‎setup/kubernetes/local-preview.md
+55-6 b/‎setup/kubernetes/local-preview.md
+55-6
@@ -3,9 +3,10 @@ title: "Local preview"
 description: Set up a Coder deployment locally for testing.
 ---
 
-Coder is typically deployed onto Kubernetes cluster, but if you would like to
-set up a lightweight preview deployment, you can do so locally using using
-[Docker][docker-url] and [kind][kind-url].
+Docker
+
+Coder is typically deployed to a remote datacenter but [Docker][docker-url] can
+be used to create a lightweight preview deployment of Coder.
 
 > Coder currently supports local preview only on workstations running macOS or
 > Linux.
@@ -18,7 +19,8 @@ Before proceeding, please make sure that you have the following installed:
 
 1. [Docker](https://hub.docker.com/search?q=docker&type=edition&offering=community)
 1. [helm](https://helm.sh/docs/intro/install)
-1. [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)
+1. [kind](https://kind.sigs.k8s.io/docs/user/quick-start/#installation) or
+   [Docker Desktop](docker-desktop-url)
 1. [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl)
 
 ## Limitations
@@ -31,7 +33,7 @@ deployment running entirely inside a Docker container.
 
 ### CVMs
 
-The local preview supports [CVMs][cvm-url] if you meet the following
+The kind deployment supports [CVMs][cvm-url] if you meet the following
 requirements (if you choose not to try out CVMs, these requirements do not
 apply):
 
@@ -62,11 +64,15 @@ workspace.
 
 We are working on bringing Dev URL support to local previews in later releases.
 
+### SSH
+
+SSH is not configured to run by default on kind deployments.
+
 ### Air-gapped clusters
 
 The local preview option does not work in an air-gapped deployment.
 
-## Installing Coder
+## Option 1) Kind
 
 To install Coder, run:
 
@@ -97,6 +103,47 @@ Password: yfu...yu2
 Visit the URL, and log in using the provided credentials. The platform is
 automatically configured for you, so there's no first-time setup to do.
 
+## Option 2) Docker Desktop
+
+[Docker Desktop](docker-desktop-url) includes a standalone Kubernetes server and
+client, which can be used to run Coder.
+
+> Note: While this option does support [SSH access](../../workspaces/ssh) to
+> workspaces, you must not have an existing SSH server running on port 22.
+
+1. Follow [Docker's docs](docker-k8s-docs) to enable the Kubernetes cluster
+1. Ensure Docker has enough resources allocated to meet
+   [Coder's requirements](https://coder.com/docs/coder/v1.20/setup/requirements)
+   in Docker preferences
+
+   ![Docker Desktop Resources](../../assets/setup/docker-desktop-resources.png)
+
+1. Install [metrics-server](https://github.com/kubernetes-sigs/metrics-server)
+   for Coder to get valid metrics from your cluster
+
+   ```console
+   helm repo add bitnami https://charts.bitnami.com/bitnami
+   ```
+
+1. Proceed to our [install docs](../installation) to install Coder on your
+   cluster
+
+If you run into `OutOfmemory` errors when installing, try increasing your
+resource allocation in Docker. If that fails install Coder with the following
+helm values:
+
+```console
+helm upgrade --install coder \
+    --set ingress.useDefault=false \
+    --set cemanager.resources.requests.cpu="0m" \
+    --set cemanager.resources.requests.memory="0Mi" \
+    --set envproxy.resources.requests.cpu="0m" \
+    --set envproxy.resources.requests.memory="0Mi" \
+    --set timescale.resources.requests.cpu="0m" \
+    --set timescale.resources.requests.memory="0Mi" \
+    coder/coder
+```
+
 ## Removing Coder
 
 To remove the local Coder deployment, run:
@@ -109,6 +156,8 @@ Because Coder runs inside Docker, you should have nothing left on your machine
 after tear down.
 
 [docker-url]: https://www.docker.com/
+[docker-desktop-url]: https://www.docker.com/products/docker-desktop
+[docker-k8s-docs]: https://docs.docker.com/desktop/kubernetes/
 [kind-url]: https://kind.sigs.k8s.io/
 [cvm-url]: https://coder.com/docs/workspaces/cvms
 [docker-mac-url]: