Skip to main content
Opens one or more local TCP tunnels to a running agent’s VM. Each tunnel binds a random local port and forwards traffic to the specified remote port on the VM. Keeps running until you press Ctrl-C.

​
Synopsis

murmur port-forward [flags] <slug> <port> [port ...]
Pass one or more port numbers. Each one creates a separate tunnel. The command prints the local port assigned to each tunnel on startup.

​
Arguments

NameTypeRequiredDescription
slugstringyesThe agent’s slug.
portintyesOne or more remote port numbers on the VM (1—65535). At least one is required.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.
--insecureboolnoConnect to the tunnel endpoint without TLS. Default: false.
The --insecure flag disables TLS on the tunnel connection. Only use it for local development when the tunnel endpoint does not have a certificate configured.

​
Examples

​
Forward a single port

murmur port-forward fix-auth 8080

Tunneling to fix-auth via port-proxy.example.com:443...
✓ localhost:54321 → remote:8080
Press Ctrl-C to close all tunnels.
Open http://localhost:54321 in your browser to reach the service running on port 8080 of the agent’s VM.

​
Forward multiple ports

murmur port-forward fix-auth 3000 5432

Tunneling to fix-auth via port-proxy.example.com:443...
✓ localhost:61200 → remote:3000
✓ localhost:61201 → remote:5432
Press Ctrl-C to close all tunnels.
Each remote port gets its own local port. Both tunnels stay open until you press Ctrl-C.

​
Forward a database port from another workspace

murmur port-forward --workspace data-team etl-runner 5432

Tunneling to etl-runner via port-proxy.example.com:443...
✓ localhost:52100 → remote:5432
Press Ctrl-C to close all tunnels.

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug. Use murmur ls to list running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
FAILED_PRECONDITIONThe agent’s VM is not running.The agent may be sleeping. Run murmur wake first.
port-forward is not supported on VMsYou ran murmur port-forward from inside an agent VM.Run this command from your laptop, not from a VM.
invalid portA port argument is not a number or is outside 1—65535.Pass valid port numbers as positional arguments.
no ports specifiedNo port arguments were provided.Add at least one port number after the slug.