Skip to main content
Use devbox url to expose HTTP ports through devbox.so, retrieve or remove exposed URLs, and inspect or change access for all exposed URLs on a Devbox.

Usage

Options

boolean
default:"false"
Include Devboxes owned by other workspace members when selecting a Devbox. This option is inherited by each devbox url subcommand.

devbox url expose

Expose one or more ports. Repeating an existing matching exposure returns it instead of creating a duplicate. A name can only be used when exposing one port.
devbox url create is an alias for devbox url expose.

Usage

Expose an HTTP port

Options

uints
default:"[]"
required
Specify a port to expose. Repeat the option or use a comma-separated value to expose multiple ports. Ports must be between 1 and 65535 without duplicates.
string
Set access for all exposed URLs to private or workspace after exposing the requested ports.
string
Assign a name to a single exposed port.
string
Set the output format to json or table. Leave empty for the default table.

devbox url unexpose

Remove exposed URLs by port or by name. Specify exactly one selector form. Ports or names that are not currently exposed are ignored.
devbox url delete is an alias for devbox url unexpose.

Usage

Remove an exposed URL

Options

string
Remove the URL with this name. Specify exactly one of --name or --port.
string
Accept an output format of json or table. This version produces no output when URLs are removed.
uints
default:"[]"
Remove URLs for these ports. Repeat the option or use a comma-separated value. Specify exactly one of --port or --name.

devbox url get

Return exposed URLs selected by port or by name. Specify exactly one selector form. Every requested port, or the requested name, must have an exposed URL.

Usage

Get a URL by name

Options

string
Return the exposed URL with this name. Specify exactly one of --name or --port.
string
Set the output format to json or table. Leave empty for the default table.
uints
default:"[]"
Return URLs for these ports. Repeat the option or use a comma-separated value. Specify exactly one of --port or --name.

devbox url list

List all exposed HTTP URLs for a Devbox, sorted by port number.

Usage

List exposed URLs as JSON

Options

string
Set the output format to json or table. Leave empty for the default table.

devbox url access

Print the current access mode for a Devbox’s exposed URLs. Pass --mode to change the mode to owner-only private access or workspace-wide workspace access.

Usage

Set workspace access

Options

string
Set the access mode to private or workspace. Leave empty to inspect the current mode without changing it.
string
Set the output format to json or text. Leave empty for the default text output.

Remote development

Access services running on a Devbox.
Last modified on August 28, 2026