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).
+
+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 @@
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.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies: