Accessing Web Servers Running Within Your Environment

Developer (Dev) URLs allow users to access the web services they are developing within their environment.

Prerequisites

You must have DevURLs enabled in your installation.

Creating a Dev URL

You can create a Dev URL from the environment overview page. In the Dev URLs section, click Add URL. Provide the port number you'd like to use, an optional Name, as well as whether the URL should be public, private, available to others in your organization, or to anyone logged into your instance of Coder.

Using Dev URLs

To access a Dev URL, click the Open in browser icon to open it in a new page, or the Copy button to copy the URL for sharing.

Direct Access

Dev URLs are constructed as follows. If a name is provided:

<name>-<username>.domain

If no name is provided:

<port>-<environment_name>-<username>.domain

As an example, a Dev URL for port 8080 can be constructed for:

• Username: user
• Domain: acme.com
• Environment: my-project

as: 8080-my-project-user.acme.com, or if given the name reactproject

as: reactproject-user.acme.com

If not already present, Dev URLs that are directly accessed will be automatically added to the Dev URL list on the dashboard. Their access will be set to Private.

Access Control

Each Dev URL can set an access level. The options are:

• Private - Only the owner of the environment can access the URL
• Organization - Anyone in the same organization as the environment can access the URL
• Authorized Users - Anyone logged in to your instance of Coder
• Public - Anyone on the internet

Working with Dev URLs using the Coder CLI

The Coder CLI comes with features for you to use and manage your Dev URLs.

Usage

To list all existing Dev URLs: coder urls <env name>
To create/edit or delete Dev URLs: coder urls [create | del] <env name> <port>

Example: Creating Dev URLs

$ coder urls create my-env 8001
$ coder urls create my-env 8002 --access PUBLIC

Example: Listing Dev URLs

$ coder urls ls my-env

Port                                            Access
https://8080-admin-dev.devurl.company.dev/ 8080 PUBLIC
https://3000-admin-dev.devurl.company.dev/ 3000 PRIVATE

Example: Editing Dev URLs

The create subcommand can also be used to update an existing DevURL. To do so, specify the <port> for an existing Dev URL and supply a new --access value.

Example: Deleting Dev URLs

$ coder urls del my-env 8000