docs: document how to run workspace-proxy as a system service (coder#12810)

michaelbrewer · matifali · web-flow · commit 8e2d026d99b8 · 2024-03-29T15:06:32.000Z
* docs: document how to run workspace-proxy as a system service

* Update workspace-proxies.md

* Update workspace-proxies.md

Co-authored-by: Muhammad Atif Ali &lt;me@matifali.dev&gt;

* docs: fix duplication

---------

Co-authored-by: Muhammad Atif Ali &lt;me@matifali.dev&gt;
diff --git a/docs/admin/configure.md b/docs/admin/configure.md
@@ -130,8 +130,8 @@ steps:
 
 ## System packages
 
-If you've installed Coder via a [system package](../install/index.md) Coder, you
-can configure the server by setting the following variables in
+If you've installed Coder via a [system package](../install/index.md), you can
+configure the server by setting the following variables in
 `/etc/coder.d/coder.env`:
 
 ```env
diff --git a/docs/admin/workspace-proxies.md b/docs/admin/workspace-proxies.md
@@ -147,6 +147,28 @@ and up the deployment's replicas.
 coder wsproxy server
 ```
 
+### Running as a system service
+
+If you've installed Coder via a [system package](../install/index.md), you can
+configure the workspace proxy by settings in
+`/etc/coder.d/coder-workspace-proxy.env`
+
+To run workspace proxy as a system service on the host:
+
+```bash
+# Use systemd to start workspace proxy now and on reboot
+sudo systemctl enable --now coder-workspace-proxy
+
+# View the logs to ensure a successful start
+journalctl -u coder-workspace-proxy.service -b
+```
+
+To restart workspace proxy after applying system changes:
+
+```shell
+sudo systemctl restart coder-workspace-proxy
+```
+
 ### Running in Docker
 
 Modify the default entrypoint to run a workspace proxy server instead of a
