> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# murmur url port

> Print the ephemeral port-proxy URL for one or more ports on the current agent's VM — for sharing dev servers and previews from local agents.

Prints a publicly-reachable URL for each specified port on the current [agent's](/concepts/agents) VM. Each URL routes through the port proxy, so external tools and browsers can reach services the [agent](/concepts/agents) is running without a tunnel.

This command runs only on a VM. It reads the [agent's](/concepts/agents) identity from the environment and constructs the URL locally — no API call is made.

## Synopsis

```bash theme={null}
murmur url port <port> [port ...]
```

## Arguments

| Name   | Type | Required | Description                                                                    |
| ------ | ---- | -------- | ------------------------------------------------------------------------------ |
| `port` | int  | yes      | One or more port numbers (1--65535). Each port prints one URL on its own line. |

## Examples

### Single port

```bash theme={null}
murmur url port 3000
```

```
https://github-acme-a1b2c3d4e5f6-3000.port.murmur.example.com/
```

### Multiple ports

```bash theme={null}
murmur url port 3000 8080
```

```
https://github-acme-a1b2c3d4e5f6-3000.port.murmur.example.com/
https://github-acme-a1b2c3d4e5f6-8080.port.murmur.example.com/
```

Each port produces one line of output, in the order given.

## Errors

| Code                         | Meaning                                                        | What to do                                                                                                      |
| ---------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `MURMUR_WORKFLOW_ID not set` | The command is not running on an [agent](/concepts/agents) VM. | Run `murmur url port` from inside a VM. On your laptop, use [`murmur port-forward`](/cli/port-forward) instead. |
| `invalid port`               | A port argument is not a number or is outside 1--65535.        | Pass valid port numbers.                                                                                        |
| `port proxy not configured`  | The `public_url` field is missing from `murmur.yaml`.          | Set `public_url` in your [configuration](/configuration/murmur-yaml).                                           |

## Related

* [Agents](/concepts/agents) — concept overview
* [`murmur url agent`](/cli/url-agent) — print the dashboard URL for an [agent](/concepts/agents)
* [`murmur port-forward`](/cli/port-forward) — tunnel to a port from your laptop
* [`murmur status`](/cli/status) — check an [agent's](/concepts/agents) phase and progress