diff --git a/deploy-container/README.md b/deploy-container/README.md
index b8b2ec5e..40e9a008 100644
--- a/deploy-container/README.md
+++ b/deploy-container/README.md
@@ -9,6 +9,17 @@ An container image built for deploying code-server.
 
 Docker Hub: `bencdr/code-server-deploy-container`
 
+To run the container locally, you can use:
+
+```console
+docker run -p 127.0.0.1:8080:8080 \
+  -v "$PWD/project:/home/coder/project" \
+  -u "$(id -u):$(id -g)" \
+  -e "DOCKER_USER=$USER" \
+  -e "PASSWORD=12345" \
+  -it bencdr/code-server-deploy-container:latest
+```
+
 ## Modifying your code-server environment
 
 To update your code-server version, modify the version number on line 2 in your Dockerfile. See the [list of tags](https://hub.docker.com/r/codercom/code-server/tags?page=1&ordering=last_updated) for the latest version.
diff --git a/deploy-vm/README.md b/deploy-vm/README.md
index 3232fea1..71d2a4e3 100644
--- a/deploy-vm/README.md
+++ b/deploy-vm/README.md
@@ -4,11 +4,40 @@ A simple startup script to run code-server with --link on a VM, designed to run
 
 **Coming soon:** One-click templates in popular marketplaces.
 
-## In this repo:
+## In this repo
 
 - [launch-code-server.sh](./launch-code-server.sh) - Command tested on Ubuntu machines (uses --link)
 - [launch-linode.sh](./launch-linode.sh) - launch-code-server.sh adapted for Linode
 
-## Other scripts:
+## Troubleshooting
 
-- [code-server, CloudFlare, and Caddy](https://github.com/alec-hs/coder-cloudflare-setup): Sets up code-server and configures CloudFlare DNS 
+- Ensure you have port 80 open on your server's firewall
+
+- SSH or use the built-in console to connect to your workspace
+
+  1. Check the code-server status
+
+     ```console
+     systemctl status code-server@coder
+
+     # if not working:
+     systemctl restart code-server@coder
+     ```
+
+  1. Ensure journalctl is capturing logs
+
+     ```console
+     journalctl -u code-server@coder
+     ```
+
+  1. Ensure the HTTP redirect server is working
+
+     ```console
+     systemctl status coder-cloud-redirect
+
+     # systemctl restart coder-cloud-redirect
+     ```
+
+## Other scripts
+
+- [code-server, CloudFlare, and Caddy](https://github.com/alec-hs/coder-cloudflare-setup): Sets up code-server and configures CloudFlare DNS
diff --git a/guides/aws-ec2.md b/guides/aws-ec2.md
index 9ca1c211..f9361abc 100644
--- a/guides/aws-ec2.md
+++ b/guides/aws-ec2.md
@@ -28,3 +28,5 @@
 sudo hostnamectl set-hostname bens-devbox
 sudo systemctl restart code-server@coder
 ```
+
+See our [troubleshooting guide](../deploy-vm#troubleshooting) if you are unable to connect after some time.
diff --git a/guides/digitalocean.md b/guides/digitalocean.md
index f19a35b5..3cad2c97 100644
--- a/guides/digitalocean.md
+++ b/guides/digitalocean.md
@@ -11,3 +11,5 @@
 1. Once your server starts, you can simply navigate to the IP address and get forwarded to a secure version of code-server, which will be proxied behind your GitHub account. For information on how this works, see [code-server --link](https://github.com/cdr/code-server#cloud-program-%EF%B8%8F).
 
    <img src="https://github.com/img/digitalocean-launch-code-server.gif" alt="DigitalOcean launch code-server" width="800" />
+
+See our [troubleshooting guide](../deploy-vm#troubleshooting) if you are unable to connect after some time.
diff --git a/guides/linode.md b/guides/linode.md
index d4aefd4e..8af0a5c0 100644
--- a/guides/linode.md
+++ b/guides/linode.md
@@ -13,7 +13,10 @@
    <img src="https://github.com/img/linode-launch-code-server.gif" alt="Linode launch code-server" width="700" />
 
 1. Optional: To change the URL in the address bar from `linode-[xxxx]` to something more descriptive, you just need to change your hostname and restart code-server:
+
    ```sh
    sudo hostnamectl set-hostname bens-devbox
    sudo systemctl restart code-server@coder
    ```
+
+See our [troubleshooting guide](../deploy-vm#troubleshooting) if you are unable to connect after some time.