From f5cb8af747d53c3fb01ad7787104f910f9bdf0a6 Mon Sep 17 00:00:00 2001 From: Ngo Quoc Dat Date: Tue, 20 Oct 2026 20:34:57 +0700 Subject: [PATCH] docs(connections): name the Local Network permission prompt TablePro now shows --- connections/socks-proxy.mdx | 2 +- connections/ssh-tunneling.mdx | 2 +- troubleshooting.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/connections/socks-proxy.mdx b/connections/socks-proxy.mdx index 8a64afb2..3ec6e61c 100644 --- a/connections/socks-proxy.mdx +++ b/connections/socks-proxy.mdx @@ -73,7 +73,7 @@ Fifteen seconds passed with no path to the database. The proxy did not answer, r ### Local network permission prompt -On macOS 15 and later, a proxy on your local network (a `192.168.x.x` address) raises the one-time Local Network alert. Allow it, or the proxy stays unreachable. A loopback proxy such as `ssh -D` on `127.0.0.1` never triggers it. +On macOS 15 and later, a proxy on your local network (a `192.168.x.x` address) raises the one-time Local Network alert. Allow it, or the proxy stays unreachable: the window then reads **Local Network Access Required** and names the proxy, and **Open System Settings** takes you to **Privacy & Security**, where **Local Network** lists TablePro. A loopback proxy such as `ssh -D` on `127.0.0.1` never triggers it. ### The database rejects the connection diff --git a/connections/ssh-tunneling.mdx b/connections/ssh-tunneling.mdx index fda6a1db..b09259a9 100644 --- a/connections/ssh-tunneling.mdx +++ b/connections/ssh-tunneling.mdx @@ -183,7 +183,7 @@ The local end of the tunnel listens on a port between 60000 and 65000. Allow it. ### SSH fails instantly against a server on your own network -macOS 15 and later put outbound connections to local network addresses behind a Local Network permission, and a denied app fails fast with "no route to host". Check TablePro under **System Settings > Privacy & Security > Local Network**. Servers over the internet, and anything on `127.0.0.1`, are unaffected. +macOS 15 and later put outbound connections to local network addresses behind a Local Network permission. With it off, the window reads **Local Network Access Required** and names the SSH server, or the first jump host, it could not reach. **Open System Settings** takes you to **Privacy & Security**, where **Local Network** lists TablePro. Servers over the internet, and anything on `127.0.0.1`, are unaffected. ### SSH itself fails diff --git a/troubleshooting.mdx b/troubleshooting.mdx index a312404b..975a5299 100644 --- a/troubleshooting.mdx +++ b/troubleshooting.mdx @@ -31,7 +31,7 @@ A failed connect paints the window with **Could not connect to `…`**, the driv - **Refused** means something answered and said no: the server is not listening on that port, or it is bound to `127.0.0.1` only. **Timed out** means nothing answered, which points at a firewall, a security group or a VPN. Tell them apart with `nc -zv host port`. - **Still on Connecting**: after 12 seconds on one step the pane says "This is taking longer than usual." **Cancel** gives up at once and drops that connection from **Reopen Last Session**; a connect that fails on its own keeps its place there. -- On macOS 15 and later, a database at a local network address (`192.168.x.x`, `.local`) needs the Local Network permission. Grant it to TablePro under **System Settings > Privacy & Security > Local Network**. Loopback and internet hosts are unaffected. +- On macOS 15 and later, a host at a local network address (`192.168.x.x`, `10.x.x.x`, `.local`) needs the Local Network permission. Without it the window reads **Local Network Access Required** and names the host it could not reach: the database, the SSH server or jump host, or the SOCKS proxy. **Open System Settings** takes you to **Privacy & Security**; turn TablePro on under **Local Network**, then click **Try Again**. **Copy Details** still holds the driver's message. Loopback and internet hosts are unaffected. - Authentication failures are engine-specific. See [PostgreSQL](/databases/postgresql), [MySQL](/databases/mysql) or [SQL Server](/databases/mssql). ## TLS and certificates