Port Forwarding
Local Port Forwarding
Forward a remote port to your local machine over an SSH tunnel.
Local port forwarding maps a port on your local machine to a port on the remote server (or a host reachable from the remote server). This is the most common type of SSH tunnel.
Common use cases
- Access a remote PostgreSQL database (
5432) onlocalhost:15432 - Reach a web UI behind a firewall via
localhost:8080 - Connect to Redis, Elasticsearch, or any other service not exposed to the public internet
Adding a local forward
- Go to Connections → Port Forwarding.
- Click New Tunnel → Local.
- Fill in:
| Field | Example | Description |
|---|---|---|
| Connection | prod-server | The SSH host to tunnel through |
| Local port | 15432 | Port on your machine |
| Remote host | 127.0.0.1 | Target host from the SSH server's perspective |
| Remote port | 5432 | Target port on the remote host |
| Label | Prod DB | Friendly name |
- Save, then toggle the tunnel Active.
How it works
Your Machine SSH Server Target Service
localhost:15432 ─→ SSH channel ─→ 127.0.0.1:5432While the tunnel is active, any connection to localhost:15432 is forwarded through the SSH channel to 127.0.0.1:5432 on the server.
Stopping a tunnel
Toggle the Active switch off on the tunnel card, or close the associated SSH session tab.