diff --git a/docs/faqs.md b/docs/faqs.md
index 5f4f687b496c6..7a599ca7a9d3e 100644
--- a/docs/faqs.md
+++ b/docs/faqs.md
@@ -4,7 +4,8 @@ Frequently asked questions on Coder OSS and Enterprise deployments. These FAQs
come from our community and enterprise customers, feel free to
[contribute to this page](https://github.com/coder/coder/edit/main/docs/faqs.md).
-## How do I add an enterprise license?
+
+ How do I add an enterprise license?
Visit https://coder.com/trial or contact
[sales@coder.com](mailto:sales@coder.com?subject=License) to get a v2 enterprise
@@ -31,7 +32,10 @@ If the license is in a file:
coder licenses add -f
```
-## I'm experiencing networking issues, so want to disable Tailscale, STUN, Direct connections and force use of websockets
+
+
+
+ I'm experiencing networking issues, so want to disable Tailscale, STUN, Direct connections and force use of websockets
The primary developer use case is a local IDE connecting over SSH to a Coder
workspace.
@@ -58,13 +62,19 @@ troubleshooting.
| [`CODER_DERP_SERVER_STUN_ADDRESSES`](https://coder.com/docs/v2/latest/cli/server#--derp-server-stun-addresses) | `"disable"` | Disables STUN |
| [`CODER_DERP_FORCE_WEBSOCKETS`](https://coder.com/docs/v2/latest/cli/server#--derp-force-websockets) | `true` | Forces websockets over Tailscale DERP |
-## How do I configure NGINX as the reverse proxy in front of Coder?
+
+
+
+ How do I configure NGINX as the reverse proxy in front of Coder?
[This doc](https://github.com/coder/coder/tree/main/examples/web-server/nginx#configure-nginx)
in our repo explains in detail how to configure NGINX with Coder so that our
Tailscale Wireguard networking functions properly.
-## How do I hide some of the default icons in a workspace like VS Code Desktop, Terminal, SSH, Ports?
+
+
+
+ How do I hide some of the default icons in a workspace like VS Code Desktop, Terminal, SSH, Ports?
The visibility of Coder apps is configurable in the template. To change the
default (shows all), add this block inside the
@@ -83,7 +93,10 @@ of a template and configure as needed:
This example will hide all built-in coder_app icons except the web terminal.
-## I want to allow code-server to be accessible by other users in my deployment.
+
+
+
+ I want to allow code-server to be accessible by other users in my deployment.
> It is **not** recommended to share a web IDE, but if required, the following
> deployment environment variable settings are required.
@@ -113,7 +126,10 @@ resource "coder_app" "code-server" {
}
```
-## I installed Coder and created a workspace but the icons do not load.
+
+
+
+ I installed Coder and created a workspace but the icons do not load.
An important concept to understand is that Coder creates workspaces which have
an agent that must be able to reach the `coder server`.
@@ -137,7 +153,10 @@ coder server --access-url http://localhost:3000 --address 0.0.0.0:3000
> Even `coder server` which creates a reverse proxy, will let you use
> http://localhost to access Coder from a browser.
-## I updated a template, and an existing workspace based on that template fails to start.
+
+
+
+ I updated a template, and an existing workspace based on that template fails to start.
When updating a template, be aware of potential issues with input variables. For
example, if a template prompts users to choose options like a
@@ -157,7 +176,10 @@ potentially saving the workspace from a failed status.
coder update --always-prompt
```
-## I'm running coder on a VM with systemd but latest release installed isn't showing up.
+
+
+
+ I'm running coder on a VM with systemd but latest release installed isn't showing up.
Take, for example, a Coder deployment on a VM with a 2 shared vCPU systemd
service. In this scenario, it's necessary to reload the daemon and then restart
@@ -172,7 +194,10 @@ sudo systemctl daemon-reload
sudo systemctl restart coder.service
```
-## I'm using the built-in Postgres database and forgot admin email I set up.
+
+
+
+ I'm using the built-in Postgres database and forgot admin email I set up.
1. Run the `coder server` command below to retrieve the `psql` connection URL
which includes the database user and password.
@@ -185,7 +210,10 @@ coder server postgres-builtin-url
psql "postgres://coder@localhost:53737/coder?sslmode=disable&password=I2S...pTk"
```
-## How to find out Coder's latest Terraform provider version?
+
+
+
+ How to find out Coder's latest Terraform provider version?
[Coder is on the HashiCorp's Terraform registry](https://registry.terraform.io/providers/coder/coder/latest).
Check this frequently to make sure you are on the latest version.
@@ -194,7 +222,10 @@ Sometimes, the version may change and `resource` configurations will either
become deprecated or new ones will be added when you get warnings or errors
creating and pushing templates.
-## How can I set up TLS for my deployment and not create a signed certificate?
+
+
+
+ How can I set up TLS for my deployment and not create a signed certificate?
Caddy is an easy-to-configure reverse proxy that also automatically creates
certificates from Let's Encrypt.
@@ -209,17 +240,20 @@ coder.example.com {
reverse_proxy 127.0.0.1:3000
- tls {
+ tls {
- issuer acme {
- email user@example.com
- }
+ issuer acme {
+ email user@example.com
+ }
- }
+ }
}
```
-## I'm using Caddy as my reverse proxy in front of Coder. How do I set up a wildcard domain for port forwarding?
+
+
+
+ I'm using Caddy as my reverse proxy in front of Coder. How do I set up a wildcard domain for port forwarding?
Caddy requires your DNS provider's credentials to create wildcard certificates.
This involves building the Caddy binary
@@ -235,21 +269,24 @@ The updated Caddyfile configuration will look like this:
```text
*.coder.example.com, coder.example.com {
- reverse_proxy 127.0.0.1:3000
+ reverse_proxy 127.0.0.1:3000
- tls {
- issuer acme {
- email user@example.com
- dns googleclouddns {
- gcp_project my-gcp-project
- }
- }
- }
+ tls {
+ issuer acme {
+ email user@example.com
+ dns googleclouddns {
+ gcp_project my-gcp-project
+ }
+ }
+ }
}
```
-## Can I use local or remote Terraform Modules in Coder templates?
+
+
+
+ Can I use local or remote Terraform Modules in Coder templates?
One way is to reference a Terraform module from a GitHub repo to avoid
duplication and then just extend it or pass template-specific
@@ -291,8 +328,10 @@ References:
- [Public Github Issue 6117](https://github.com/coder/coder/issues/6117)
- [Public Github Issue 5677](https://github.com/coder/coder/issues/5677)
- [Coder docs: Templates/Change Management](https://coder.com/docs/v2/latest/templates/change-management)
+
-## Can I run Coder in an air-gapped or offline mode? (no Internet)?
+
+ Can I run Coder in an air-gapped or offline mode? (no Internet)?
Yes, Coder can be deployed in air-gapped or offline mode.
https://coder.com/docs/v2/latest/install/offline
@@ -306,7 +345,10 @@ defaults to Google's STUN servers, so you can either create your STUN server in
your network or disable and force all traffic through the control plane's DERP
proxy.
-## Create a randomized computer_name for an Azure VM
+
+
+
+ Create a randomized computer_name for an Azure VM
Azure VMs have a 15 character limit for the `computer_name` which can lead to
duplicate name errors.
@@ -321,7 +363,10 @@ locals {
}
```
-## Do you have example JetBrains Gateway templates?
+
+
+
+ Do you have example JetBrains Gateway templates?
In August 2023, JetBrains certified the Coder plugin signifying enhanced
stability and reliability.
@@ -342,8 +387,10 @@ open the IDE.
- [IntelliJ IDEA](https://github.com/sharkymark/v2-templates/tree/main/pod-idea)
- [IntelliJ IDEA with Icon](https://github.com/sharkymark/v2-templates/tree/main/pod-idea-icon)
+
-## What options do I have for adding VS Code extensions into code-server, VS Code Desktop or Microsoft's Code Server?
+
+ What options do I have for adding VS Code extensions into code-server, VS Code Desktop or Microsoft's Code Server?
Coder has an open-source project called
[`code-marketplace`](https://github.com/coder/code-marketplace) which is a
@@ -369,7 +416,10 @@ https://github.com/sharkymark/v2-templates/blob/main/vs-code-server/main.tf
> Note: these are example templates with no SLAs on them and are not guaranteed
> for long-term support.
-## I want to run Docker for my workspaces but not install Docker Desktop.
+
+
+
+ I want to run Docker for my workspaces but not install Docker Desktop.
[Colima](https://github.com/abiosoft/colima) is a Docker Desktop alternative.
@@ -404,7 +454,10 @@ Colima will show the path to the docker socket so I have a
[Coder template](./docker-code-server/main.tf) that prompts the Coder admin to
enter the docker socket as a Terraform variable.
-## How to make a `coder_app` optional?
+
+
+
+ How to make a `coder_app` optional?
An example use case is the user should decide if they want a browser-based IDE
like code-server when creating the workspace.
@@ -462,7 +515,10 @@ resource "coder_app" "code-server" {
}
```
-## Why am I getting this "remote host doesn't meet VS Code Server's prerequisites" error when opening up VSCode remote in a Linux environment?
+
+
+
+ Why am I getting this "remote host doesn't meet VS Code Server's prerequisites" error when opening up VSCode remote in a Linux environment?
@@ -472,3 +528,5 @@ instance, Alpine is not supported at all. If so, you need to find a container
image or supported OS for the VS Code Server. For more information on OS
prerequisites for Linux, please look at the VSCode docs.
https://code.visualstudio.com/docs/remote/linux#_local-linux-prerequisites
+
+