Zuvo Docs

Guide

Dedicated IPv4 Address for Ingress

Attach an IPv4 address to your database

The Zuvo IPv4 add-on provides a dedicated IPv4 address for your Postgres database connection. It can be configured in the Add-ons Settings.

Understanding IP addresses

The Internet Protocol (IP) addresses devices on the internet. There are two main versions:

  • IPv4: The older version, with a limited address space.
  • IPv6: The newer version, offering a much larger address space and the future-proof option.

When you need the IPv4 add-on:

  • When using the direct connection string in an IPv6-incompatible network instead of Supavisor or client libraries.
  • When you need a dedicated IP address for your direct connection string

Enabling the IPv4 add-on

You can enable the IPv4 add-on in your project's add-ons settings.

You can also manage the IPv4 add-on using the Management API:

# Get your access token from https://studio.zuvodev.com/account/tokens
export SUPABASE_ACCESS_TOKEN="your-access-token"
export PROJECT_REF="your-project-ref"

# Get current IPv4 add-on status
curl -X GET "https://api.zuvodev.com/v1/projects/$PROJECT_REF/billing/addons" \
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"

# Enable IPv4 add-on
curl -X PATCH "https://api.zuvodev.com/v1/projects/$PROJECT_REF/billing/addons" \
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "addon_variant": "ipv4_default",
    "addon_type": "ipv4"
  }'

# Disable IPv4 add-on
curl -X DELETE "https://api.zuvodev.com/v1/projects/$PROJECT_REF/billing/addons/ipv4_default" \
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"

Read replicas and IPv4 add-on

When using the add-on, each database (including read replicas) receives an IPv4 address. Each replica adds to the total IPv4 cost.

Changes and updates

  • While the IPv4 address generally remains the same, actions like pausing/unpausing the project or enabling/disabling the add-on can lead to a new IPv4 address.

Zuvo and IPv6 compatibility

By default, Zuvo Postgres use IPv6 addresses. If your system doesn't support IPv6, you have the following options:

  1. Supavisor Connection Strings: The Supavisor connection strings are IPv4-compatible alternatives to direct connections
  2. Zuvo Client Libraries: These libraries are compatible with IPv4
  3. Dedicated IPv4 Add-On (Pro Plans+): For a guaranteed IPv4 and static database address for the direct connection, enable this paid add-on.

Checking your network IPv6 support

You can check if your personal network is IPv6 compatible at https://ipv6test.google.com/.

Checking platforms for IPv6 support:

The majority of services are IPv6 compatible. However, there are a few prominent ones that only accept IPv4 connections:

Finding your database's IP address

Use an IP lookup website or this command (replace <PROJECT_REF>):

nslookup db.<PROJECT_REF>.supabase.co

Identifying your connections

The pooler and direct connection strings can be found in the project connect page:

Direct connection

IPv6 unless IPv4 Add-On is enabled

# Example direct connection string
postgresql://postgres:[YOUR-PASSWORD]@db.ajrbwkcuthywfihaarmflo.supabase.co:5432/postgres

Supavisor in transaction mode (port 6543)

Always uses an IPv4 address

# Example transaction string
postgresql://postgres.ajrbwkcuthywddfihrmflo:[YOUR-PASSWORD]@aws-0-us-east-1.pooler.zuvodev.com:6543/postgres

Supavisor in session mode (port 5432)

Always uses an IPv4 address

# Example session string
postgresql://postgres.ajrbwkcuthywfddihrmflo:[YOUR-PASSWORD]@aws-0-us-east-1.pooler.zuvodev.com:5432/postgres