Skip to main content

Port-Forward Tunnels (SSH)

Gatwy supports configuring local→remote SSH port forwards directly in the connection settings — no separate SSH client required.

How It Works​

When you open an SSH session, Gatwy establishes any configured tunnels automatically. The tunnels:

  • Start when the SSH session connects
  • Show status in the session bar (🟢 listening / 🔴 failed, with error message)
  • Close when the SSH session closes

Configuring Tunnels​

  1. Open the connection editor for an SSH connection
  2. Navigate to the Port Forwards section
  3. Add one or more tunnels:
    • Local port — the port on your machine to listen on
    • Remote host — the host to forward to (relative to the SSH server)
    • Remote port — the destination port

Use Cases​

  • Access a database on a private network through an SSH jump host
  • Tunnel HTTP traffic through a bastion server
  • Expose a remote service locally for testing

Status Indicators​

Each configured tunnel displays its current state in the active session bar:

IndicatorMeaning
🟢Tunnel is listening and active
🔴Tunnel failed — hover for error message