coder · bpmct · Sep 8, 2022 · Sep 1, 2022 · Sep 2, 2022 · Sep 2, 2022
diff --git a/README.md b/README.md
@@ -52,7 +52,7 @@ You can modify the installation process by including flags. Run the help command
 curl -L https://coder.com/install.sh | sh -s -- --help
 ```
 
-> See [install](docs/install.md) for additional methods.
+> See [install](docs/install) for additional methods.
 
 Once installed, you can start a production deployment<sup>1</sup> with a single command:
 

diff --git a/coder.env b/coder.env
@@ -1,9 +1,18 @@
-# Run "coder server --help" for flag information.
+# Coder must be reachable from an external URL
+# for users and workspaces to connect.
+
+# Option 1) Enable CODER_TUNNEL to generate a
+# unique *. try.coder.com access URL
+CODER_TUNNEL=false
+
+# Option 2) Set an access URL
+# e.g. https://coder.example.com
 CODER_ACCESS_URL=
+
 CODER_ADDRESS=
 CODER_PG_CONNECTION_URL=
 CODER_TLS_CERT_FILE=
 CODER_TLS_ENABLE=
 CODER_TLS_KEY_FILE=
-# Generate a unique *.try.coder.app access URL
-CODER_TUNNEL=false
+
+# Run "coder server --help" for flag information.
diff --git a/docs/install/auth.md → docs/admin/auth.md b/docs/install/auth.md → docs/admin/auth.md
diff --git a/docs/install/configure.md → docs/admin/configure.md b/docs/install/configure.md → docs/admin/configure.md
@@ -1,10 +1,27 @@
-# Configure
-
-This article documents the Coder server's primary configuration variables. For a full list
+Coder server's primary configuration is done via environment variables. For a full list
 of the options, run `coder server --help` on the host.
 
-Once you've [installed](../
10000
install.md) Coder, you can configure the server by setting the following
-variables in `/etc/coder.d/coder.env`:
+## Tunnel
+
+For proof-of-concept deployments, you can set `CODER_TUNNEL=true` to run Coder on a unique `*.try.coder.app` URL.
+This is a quick way to allow users and workspaces outside your LAN to connect to Coder.
+
+## Access URL
+
+`CODER_ACCESS_URL` is required if you are not using the tunnel. Set this to the external URL
+that users and workspaces use to connect to Coder (e.g. https://coder.example.com). This
+should not be localhost.
+
+## PostgreSQL Database
+
+Coder uses a PostgreSQL database to store users, workspace metadata, and other deployment information.
+Use `CODER_PG_CONNECTION_URL` to set the database that Coder connects to. If unset, PostgreSQL binaries will be
+downloaded from Maven (https://repo1.maven.org/maven2) and store all data in the config root.
+
+## System packages
+
+If you've installed Coder via a [system package](../install/packages.md) Coder, you can
+configure the server by setting the following variables in `/etc/coder.d/coder.env`:
 
 ```sh
 # String. Specifies the external URL (HTTP/S) to access Coder.
@@ -32,17 +49,22 @@ CODER_TLS_CERT_FILE=
 CODER_TLS_KEY_FILE=
 ```
 
-## Run Coder
-
-Now, run Coder as a system service on the host:
+To run Coder as a system service on the host:
 
 ```sh
 # Use systemd to start Coder now and on reboot
 sudo systemctl enable --now coder
+
 # View the logs to ensure a successful start
 journalctl -u coder.service -b
 ```
 
+To restart Coder after applying system changes:
+
+```sh
+sudo systemctl restart Coder
+```
+
 ## Up Next
 
 - [Get started using Coder](../quickstart.md).

diff --git a/docs/admin/index.md b/docs/admin/index.md
@@ -0,0 +1,5 @@
+Get started with Coder administration:
+
+<children>
+  This page is rendered on https://coder.com/docs/coder-oss/admin. Refer to the other documents in the `admin/` directory.
+</children>
diff --git a/docs/install/upgrade.md → docs/admin/upgrade.md b/docs/install/upgrade.md → docs/admin/upgrade.md
@@ -10,7 +10,7 @@ This article walks you through how to upgrade your Coder server.
 </blockquote>
 
 To upgrade your Coder server, simply reinstall Coder using your original method
-of [install](../install.md).
+of [install](../install).
 
 ## Via install.sh
 

diff --git a/docs/users.md → docs/admin/users.md b/docs/users.md → docs/admin/users.md
diff --git a/docs/install.md b/docs/install.md