docs: split docker instructions to linux and macos

bpmct · bpmct · commit f268fd7b9423 · 2022-12-05T15:33:08.000Z
diff --git a/docs/install/docker.md b/docs/install/docker.md
@@ -9,6 +9,8 @@ Docker is required. See the [official installation documentation](https://docs.d
 For proof-of-concept deployments, you can run a complete Coder instance with
 the following command:
 
+**Linux:**
+
 ```sh
 export CODER_DATA=$HOME/.config/coderv2-docker
 export DOCKER_GROUP=$(getent group docker | cut -d: -f3)
@@ -20,6 +22,17 @@ docker run --rm -it \
   ghcr.io/coder/coder:latest
 ```
 
+**macOS:**
+
+```sh
+export CODER_DATA=$HOME/.config/coderv2-docker
+mkdir -p $CODER_DATA
+docker run --rm -it \
+  -v $CODER_DATA:/home/coder/.config \
+  -v /var/run/docker.sock:/var/run/docker.sock \
+  ghcr.io/coder/coder:latest
+```
+
 **<sup>Note:</sup>** <sup>Coder runs as a non-root user, we use `--group-add` to
 ensure Coder has permissions to manage Docker via `docker.sock`. If the host
 systems `/var/run/docker.sock` is not group writeable or does not belong to the
@@ -34,6 +47,20 @@ For production deployments, we recommend using an external PostgreSQL database
 (version 13 or higher). Set `ACCESS_URL` to the external URL that users and
 workspaces will use to connect to Coder.
 
+**Linux:**
+
+```sh
+export DOCKER_GROUP=$(getent group docker | cut -d: -f3)
+docker run --rm -it \
+  -e CODER_ACCESS_URL="https://coder.example.com" \
+  -e CODER_PG_CONNECTION_URL="postgresql://username:password@database/coder" \
+  -v /var/run/docker.sock:/var/run/docker.sock \
+  --group-add $DOCKER_GROUP \
+  ghcr.io/coder/coder:latest
+```
+
+**macOS:**
+
 ```sh
 docker run --rm -it \
   -e CODER_ACCESS_URL="https://coder.example.com" \
diff --git a/docs/quickstart/docker.md b/docs/quickstart/docker.md
@@ -15,15 +15,28 @@ Coder with Docker has the following advantages:
 
 1. Run Coder with Docker.
 
-   ```shell
+   **Linux:**
+
+   ```sh
    export CODER_DATA=$HOME/.config/coderv2-docker
    export DOCKER_GROUP=$(getent group docker | cut -d: -f3)
    mkdir -p $CODER_DATA
    docker run --rm -it \
-       -v $CODER_DATA:/home/coder/.config \
-       -v /var/run/docker.sock:/var/run/docker.sock \
-       --group-add $DOCKER_GROUP \
-       ghcr.io/coder/coder:latest
+     -v $CODER_DATA:/home/coder/.config \
+     -v /var/run/docker.sock:/var/run/docker.sock \
+     --group-add $DOCKER_GROUP \
+     ghcr.io/coder/coder:latest
+   ```
+
+   **macOS:**
+
+   ```sh
+   export CODER_DATA=$HOME/.config/coderv2-docker
+   mkdir -p $CODER_DATA
+   docker run --rm -it \
+     -v $CODER_DATA:/home/coder/.config \
+     -v /var/run/docker.sock:/var/run/docker.sock \
+     ghcr.io/coder/coder:latest
    ```
 
    > This will use Coder's tunnel and built-in database. See our [Docker documentation](../install/docker.md) for other configuration options such as running on localhost, using docker-compose, and external PostgreSQL.
