Coder server's primary configuration is done via environment variables. For a full list of the options, run coder server --help on the host.

Access URL

CODER_ACCESS_URL is required if you are not using the tunnel. Set this to the external URL that users and workspaces use to connect to Coder (e.g. This should not be localhost.

Access URL should be a external IP address or domain with DNS records pointing to Coder.


If an access URL is not specified, Coder will create a publicly accessible URL to reverse proxy your deployment for simple setup.


You can change which port(s) Coder listens on.

# Listen on port 80

# Enable TLS and listen on port 443)
export CODER_TLS_ENABLE=true

## Redirect from HTTP to HTTPS

# Start the Coder server
coder server

Wildcard access URL

CODER_WILDCARD_ACCESS_URL is necessary for port forwarding via the dashboard or running coder_apps on an absolute path. Set this to a wildcard subdomain that resolves to Coder (e.g. *

If you are providing TLS certificates directly to the Coder server, you must use a single certificate for the root and wildcard domains. Multi-certificate support is planned.

TLS Certificates

The Coder server can directly use TLS certificates with CODER_TLS_ENABLE and accompanying configuration flags. However, Coder can also run behind a reverse-proxy to terminate TLS certificates from LetsEncrypt, for example.

PostgreSQL Database

Coder uses a PostgreSQL database to store users, workspace metadata, and other deployment information. Use CODER_PG_CONNECTION_URL to set the database that Coder connects to. If unset, PostgreSQL binaries will be downloaded from Maven ( and store all data in the config root.

Postgres 13 is the minimum supported version.

If you are using the built-in PostgreSQL deployment and need to use psql (aka the PostgreSQL interactive terminal), output the connection URL with the following command:

$ coder server postgres-builtin-url
$ psql "postgres://[email protected]:49627/coder?sslmode=disable&password=feU...yI1"

System packages

If you've installed Coder via a system package Coder, you can configure the server by setting the following variables in /etc/coder.d/coder.env:

# String. Specifies the external URL (HTTP/S) to access Coder.

# String. Address to serve the API and dashboard.

# String. The URL of a PostgreSQL database to connect to. If empty, PostgreSQL binaries
# will be downloaded from Maven ( and store all
# data in the config root. Access the built-in database with "coder server postgres-builtin-url".

# Boolean. Specifies if TLS will be enabled.

# String. Specifies the path to the certificate for TLS. It requires a PEM-encoded file.
# To configure the listener to use a CA certificate, concatenate the primary
# certificate and the CA certificate together. The primary certificate should
# appear first in the combined file.

# String. Specifies the path to the private key for the certificate. It requires a
# PEM-encoded file.

To run Coder as a system service on the host:

# Use systemd to start Coder now and on reboot
sudo systemctl enable --now coder

# View the logs to ensure a successful start
journalctl -u coder.service -b

To restart Coder after applying system changes:

sudo systemctl restart coder

Up Next

Was this page helpful? Share your experience with us.


See an opportunity to improve our docs? Make an edit.

A tool that provisions remote development environments via Terraform
On this page