We use cookies to make your experience better.
Learn how to access HTTP services running inside your workspace.
Developer (dev) URLs allow you to access the web services you're developing in your workspace.
You must have dev URLs enabled in your installation.
You can create a dev URL from the workspace overview page.
In the Dev URLs section, click Add Port. First, provide the port number you want to be used and a friendly name for the URL (optional). Next, indicate who can access the URL and the internal server scheme (e.g., whether Coder should use HTTP or HTTPS when proxying requests to the internal server).
You can set the access level for each dev URL:
To access a dev URL, you can click:
There are two ways for you to construct dev URLs.
If you provided a name for the dev URL when you created it:
<name>-<username>.domain
If you didn't provide a name for the dev URL when you created it:
<port>-<workspace_name>-<username>.domain
For example, let's say that you've created a dev URL for port 8080
. Also:
user
acme.com
my-project
If you didn't name your dev URL, then your URL is
8080-my-project-user.acme.com
.
If, however, you named the dev URL reactproject
, then your URL is
reactproject-user.acme.com
.
If you access a dev URL that hasn't been created, Coder automatically adds it to your dev URL list on the dashboard and sets the access level to Private.
If you need programmatic access to authenticated dev URLs (i.e., dev URLs with access levels set to private, organization, or authorized users), you can run the following in the terminal:
# Generate an API token with the Coder CLI
$ coder tokens create devurl
<TOKEN>
# Send HTTP requests to the dev URL using the devurl_session cookie
$ curl --cookie "devurl_session=<TOKEN>" <dev-url>
You can also access your server via SSH port forwarding.
See an opportunity to improve our docs? Make an edit.