Skip to main content
When you use Hosted mode, Zwiron connects to your source and destination from its cloud infrastructure. If your database firewall only allows known IPs (Cloud SQL Authorized Networks, RDS security groups, Azure SQL firewall, etc.), you must allowlist Zwiron’s static outbound IPs. Agent mode does not use these IPs — the connection comes from your agent machine instead. See Install the Agent.

Do I need to whitelist every IP?

Yes. Whitelist all IPs in the list below. Zwiron uses multiple outbound addresses for high availability. Traffic can leave from any of them. If you allow only some:
  • Test Connection may pass but sync jobs fail, or
  • Connections work sometimes and fail other times

Hosted static egress IPs

Add each of these as a separate allowlist entry: Cloud SQL (and most cloud firewalls) label this field IP range and require CIDR notation. That does not mean you must open a whole subnet. For a single host, append /32:
Add five separate authorized networks — one per IP above — each named clearly (e.g. zwiron-1, zwiron-2).
These IPs are for outbound connections from Zwiron to your database. They are not used for inbound traffic to Zwiron.

Google Cloud SQL

Private IP alone does not work for Hosted mode. Private IP is only reachable inside your GCP VPC. Zwiron Hosted is outside that VPC. Use this setup instead:
  1. Keep Public IP enabled on the Cloud SQL instance
  2. Open Connections → Networking → Authorized Networks
  3. Click Add a network once per IP
  4. Name: e.g. zwiron-1
  5. Network / IP range: x.x.x.x/32 (CIDR — /32 = that single IP only)
  6. Click Done, then repeat for the other four IPs
  7. Save the instance and wait 1–2 minutes for the update
  8. Retry Test Connection in Zwiron
Do not click Use My IP — that would whitelist your laptop, not Zwiron. Connection string format:
If the password contains @, /, ?, or #, encode those characters in the URI (%40, %2F, %3F, %23). Other special characters are fine unencoded.

Agent mode (alternative)

If the database must stay private (no public IP), use Agent mode:
  1. Deploy a Zwiron Agent where it can reach the database
  2. Whitelist the agent machine’s egress IP (not the table above), or use private networking inside your VPC
  3. Select that agent when creating the connection

Common errors


Last modified on August 1, 2026