Troubleshooting

CLI and desktop disagree

Run:

uplink agent status

Check the state directory, socket path, log path, sidecar path, protocol version, and live snapshot.

Empty reply on local Astro/dev servers

Some dev servers bind only IPv6 loopback by default. Bind the upstream explicitly to 127.0.0.1 if the connector is dialing IPv4 loopback.

Private route denies everyone on a self-hosted edge

Account-private visitor auth needs a control plane and managed/auth-backed edge. Key-mode self-hosted edges support public, password, firewall/WAF/rate-limit, and rule-based IP/token policies.

Password route keeps prompting

Password-mode browser unlocks use the up_bearer grant, which is separate from account session cookies.