Create the workspace proxy and make sure to save the returned authentication token for said proxy. This is the token the workspace proxy will use to authenticate back to primary coderd.

$ coderproxy create --name=newyork --display-name="USA East" --icon="/emojis/2194.png"

$ coderwsproxy create --name=newyork --display-name="USA East" --icon="/emojis/2194.png"

Workspace Proxy"newyork" created successfully. Save this token, it will not be shown again.

Token: 2fb6500b-bb47-4783-a0db-dedde895b865:05271b4ef9432bac14c02b3c56b5a2d7f05453718a1f85ba7e772c0a096c7175

To verify it was created.

$ coderproxy ls

$ coderwsproxy ls

NAME URL STATUS STATUS

newyork unregistered

Deploying the workspace proxy will also register the proxy with coderd and make the workspace proxy usable. If the proxy deployment is successful,`coderproxy ls` will show an`ok` status code:

Deploying the workspace proxy will also register the proxy with coderd and make the workspace proxy usable. If the proxy deployment is successful,`coderwsproxy ls` will show an`ok` status code:

-`unregistered` : The workspace proxy was created, and not yet deployed

-`unreachable` : The workspace proxy was registered, but is not responding. Likely the proxy went offline.

-`unhealthy` : The workspace proxy is reachable, but has some issue that is preventing the proxy from being used.`coderproxy ls` should show the error message.

-`unhealthy` : The workspace proxy is reachable, but has some issue that is preventing the proxy from being used.`coderwsproxy ls` should show the error message.

-`ok` : The workspace proxy is healthy and working properly!

Workspace proxy configuration overlaps with a subset of the coderd configuration. To see the full list of configuration options:`coderproxy server --help`

Workspace proxy configuration overlaps with a subset of the coderd configuration. To see the full list of configuration options:`coderwsproxy server --help`

coderproxy server

coderwsproxy server