These frequently asked questions (FAQs) come from our community and customers, feel free to [contribute to this page](https://github.com/coder/coder/edit/main/docs/reference/faqs.md).
For other community resources, see our [GitHub discussions](https://github.com/coder/coder/discussions), or join our [Discord server](https://discord.gg/coder).
1. On the **Add a license** screen, drag your `.jwt` file into **Upload Your License** or paste it into **Paste Your License**, then select **Upload License**:
Coder's networking stack has intelligence to attempt a peer-to-peer or [Direct connection](../admin/networking/index.md#direct-connections) between the local IDE and the workspace.
However, this requires some additional protocols like User Datagram Protocol (UDP) and being able to reach a Session Traversal Utilities for Network Address Translation (STUN) server to echo the IP addresses of the local IDE machine and workspace, for sharing using a Wireguard Coordination Server.
Operators experimenting with Coder might run into networking issues if UDP (which STUN requires) or the STUN servers are unavailable, potentially resulting in lengthy local IDE and SSH connection times as the Coder control plane attempts to establish these direct connections.
[This tutorial](../admin/networking/reverse-proxy-nginx.md) in our docs explains in detail how to configure NGINX with Coder so that our Tailscale Wireguard networking functions properly.
The visibility of Coder apps is configurable in the template.
To change the default (shows all), add this block inside the [`coder_agent`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/agent) of a template and configure as needed:
This example will hide all built-in [`coder_app`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/app) icons except the web terminal.
In the template, set [`coder_app`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/app) [`share`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/app#share) option to `authenticated` and when a workspace is built with this template, the pretty globe shows up next to path-based `code-server`:
If the [`CODER_ACCESS_URL`](../admin/setup/index.md#access-url) is not accessible from a workspace, the workspace might build, but the agent cannot reach Coder, and thus the missing icons. For example, Terminal, IDEs, Apps.
If you are doing a standalone install, for example, on a MacBook and want to build workspaces in Docker Desktop, everything is self-contained and workspaces (containers in Docker Desktop) can reach the control plane.
When updating a template, be aware of potential issues with input variables.
For example, if a template prompts users to choose options like a [code-server](https://github.com/coder/code-server) [VS Code](https://code.visualstudio.com/) IDE release, a [container image](https://hub.docker.com/u/codercom), or a [VS Code extension](https://marketplace.visualstudio.com/vscode), removing any of these values can lead to existing workspaces failing to start.
This issue occurs because the Terraform state will not be in sync with the new template.
Sometimes, the version might change and `resource` configurations will either become deprecated or new ones will be added when you get warnings or errors creating and pushing templates.
This involves building the Caddy binary [from source](https://github.com/caddyserver/caddy) with the DNS provider plugin added. For example, [Google Cloud DNS provider here](https://github.com/caddy-dns/googleclouddns)
One way is to reference a Terraform module from a GitHub repo to avoid duplication and then just extend it or pass template-specific parameters/resources:
Direct networking from local SSH to a Coder workspace needs a STUN server.
Coder 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.
Selecting the most suitable template depends on how the deployment manages JetBrains IDE versions.
If downloading from [jetbrains.com](https://www.jetbrains.com/remote-development/gateway/) is acceptable, see the example templates below which specifies the product code, IDE version and build number in the [`coder_app`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/app#share) resource.
Alternatively, the IDE can be baked into the container image and manually open Gateway (or IntelliJ which has Gateway built-in), using a session token to Coder and then open the IDE.
Coder has an open-source project called [`code-marketplace`](https://github.com/coder/code-marketplace) which is a private VS Code extension marketplace.
You can also use Microsoft's code-server - which is like Coder's, but it can connect to Microsoft's extension marketplace so Copilot and chat can be retrieved there.
Colima will show the path to the docker socket so we have a [community template](https://github.com/sharkymark/v2-templates/tree/main/src/templates/docker/docker-code-server) that prompts the Coder admin to enter the Docker socket as a Terraform variable.
It is because, more than likely, the supported OS of either the container image or VM/virtual private server (VPS) doesn't have the proper C libraries to run the VS Code Server.
For more information on OS prerequisites for Linux, look at the VSCode docs. <https://code.visualstudio.com/docs/remote/linux#_local-linux-prerequisites>
If your JetBrains IDE is disconnected for a long period of time due to a network change (for example turning off a virtual private network (VPN)), you might find that the IDE will not reconnect once the network is re-established (for example turning a VPN back on).
This will make SSH check that it can contact the server every five seconds.
If it fails to do so `ServerAliveCountMax` times (3 by default for a total of 15 seconds) then it will close the connection which forces JetBrains to recreate the hung session.
You can tweak `ServerAliveInterval` and `ServerAliveCountMax` to increase or decrease the total timeout.
Note that the JetBrains Gateway configuration blocks for each host in your SSH config file will be overwritten by the JetBrains Gateway client when it re-authenticates to your Coder deployment so you must add the above config as a separate block and not add it to any existing ones.
In certain environments, it is essential to keep confidential files within workspaces and prevent users from uploading or downloading resources using tools like `scp` or `rsync`.
This control operates at the `ssh-exec` level or during `sftp` sessions.
While it can help prevent automated file transfers using the specified tools, users can still SSH into the workspace and manually initiate file transfers.
The primary purpose of this feature is to warn and discourage users from downloading confidential resources to their local machines.
Agent API capabilities, such as file operations performed by AI agents in Coder Agents chat (including chat file uploads into the workspace), are not affected by this setting because they do not go through the SSH transfer path.
The `sftp` subsystem is blocked in full, not just the `sftp` command, so any workflow that moves files over SSH File Transfer Protocol (SFTP) stops working.
You might want to change the default domain that's used to access coder, that is, `yourcompany.coder.com` and find yourself unfamiliar with the process.
For example, if you're using an environment file to configure your control plane, you'll want to edit the file located at `/etc/coder.d/coder.env` and edit the following: