Skip to content
Setup guide

PostgreSQL SSH tunneling on macOS

SSH tunneling lets you connect to private PostgreSQL instances safely over encrypted channels without exposing database ports publicly.

Prerequisites

[ 01 // REQUIREMENTS ]
  • A bastion or jump host with SSH access.
  • PostgreSQL host reachable from the bastion.
  • Database credentials with least-privilege access.

Step-by-step

[ 02 // SEQUENCE PROTOCOL ]
  1. 01Validate SSH connectivity to your bastion from your macOS machine.
  2. 02Configure local tunnel forwarding from a local port to your PostgreSQL host and port.
  3. 03Point VeloxDB connection host to localhost and use the forwarded local port.
  4. 04Enable SSL mode where required by your infrastructure policy.
  5. 05Store connection details securely and test reconnect behavior after restarting the tunnel.

Related resources & binary downloads

[ DOCS // LINKS ]