AArdentHelp Center

Guide

Setup Supabase Connection

8 stepsAgent View (JSON)

Overview

Supabase projects require network connectivity to your Postgres database, but by default they operate behind a shared IP pool. When your application or infrastructure requires a dedicated, static IPv4 address for security policies, firewall rules, or IP whitelisting, you must enable the Dedicated IPv4 address add-on. This add-on ($4.00/month per database) assigns a unique IPv4 address to your project, allowing you to connect reliably from restricted network environments. After enabling the add-on, you'll retrieve the direct connection string, which contains all credentials and connection parameters needed by your application or database client to establish a secure connection to your Postgres database.

Before you begin

  • Active Supabase account with an existing project (free or paid tier)
  • Owner or Admin role in the target Supabase project (required to modify project settings and add-ons)
  • Access to the Supabase Dashboard at supabase.com and ability to log in

Step by step

1
ClickProject Settings

Navigate to your project's settings by clicking the Project Settings link in the Supabase Dashboard. This opens the main configuration page where you can manage all project-wide settings and add-ons.

Tip. Project Settings is typically found in the left sidebar or top navigation of the Supabase Dashboard. Ensure you are in the correct project before proceeding.
Step 1
2
ClickAdd-ons

Click the Add-ons menu item to access the list of optional paid features and upgrades available for your project. This section displays all available add-ons and their current activation status.

Tip. Add-ons are listed with their monthly cost and a brief description of what each provides. Browse the full list to understand other networking and performance options available.
Step 2
3
ClickDISABLED

Locate the Dedicated IPv4 address add-on in the list and observe its current status, which displays as 'DISABLED'. This indicates the add-on is not yet active for your project.

Tip. The add-on list may be long; use your browser's find function (Ctrl+F or Cmd+F) to quickly search for 'Dedicated IPv4' if needed.
Step 3
4
ClickDedicated IPv4 address Allow database connections from IPv4 networks. $4.00 / month / database

Click on the Dedicated IPv4 address option (shown as a radio button or selectable card) to select this add-on for activation. The description confirms it costs $4.00 per month per database and allows connections from IPv4 networks.

Tip. Selecting this add-on will initiate the activation process. Ensure you understand the monthly billing impact before proceeding—it will be added to your next invoice or charged immediately depending on your billing cycle.
Warning. This action initiates a recurring monthly charge to your Supabase account. You can disable the add-on later to stop charges, but ensure this cost is acceptable before confirming.
Step 4
5
ClickConfirm

Click the Confirm button to finalize the activation of the Dedicated IPv4 address add-on. This action applies the add-on to your project and begins the provisioning process.

Tip. Confirmation may take 10–30 seconds to complete. Wait for a success message or status change before moving to the next step.
Warning. Once confirmed, the add-on is active and billing begins immediately. To cancel, you must return to Add-ons and disable it.
Step 5
6
ClickConnect

Click the Connect button to open the database connection options panel. This displays various connection methods and credentials for your newly configured database with the dedicated IPv4 address.

Tip. The Connect button appears after successful add-on activation. If it's not visible, refresh the page to ensure the add-on status has updated.
Step 6
7
ClickDirect Connection string

Click the Direct Connection string button to view and access your direct Postgres connection URL. This string contains your dedicated IPv4 address, port, username, password, and database name in a single URI format ready for use in your application.

Tip. The direct connection string is distinct from the Pooler connection string; use the direct string for applications that require a static IPv4 address. Look for a copy-to-clipboard icon or button to easily save the string.
Step 7
8
Clickbutton

Click the button (typically a copy icon or action button) to copy the direct connection string to your clipboard, making it ready to paste into your application, environment variables, or database client configuration.

Tip. Store the connection string securely—it contains your database password. Never commit it directly to version control; instead, use environment variables or secret management tools in your deployment pipeline.
Warning. The connection string contains sensitive credentials (username and password). Treat it as confidential and do not share it publicly or in unsecured channels.
Step 8

Confirm it worked

  1. 1The Dedicated IPv4 address add-on status changes from 'DISABLED' to 'ENABLED' in the Add-ons menu
  2. 2A confirmation message or success indicator appears after clicking the Confirm button
  3. 3The Direct Connection string button is accessible and displays a connection URL containing your dedicated IPv4 address (typically in the format `postgres://user:password@ip.address:5432/database`)
  4. 4The connection string appears in a modal or copy-to-clipboard interface for immediate use in your application

Common issues

Keep reading

Connect to your database

# Connect to your database Supabase provides multiple methods to connect to your Postgres database, whether you’re working on the frontend, backend, or utilizing serverless functions. ## How to conn

supabase.io

Use Supabase with React | Supabase Docs

# Use Supabase with React Learn how to create a Supabase project, add some sample data to your database, and query the data from a React app. 1. Create a Supabase project Go to database.new and cre

supabase.com

Use Supabase with Next.js | Supabase Docs

# Use Supabase with Next.js Learn how to create a Supabase project, add some sample data, and query from a Next.js app. 1. Create a Supabase project Go to database.new and create a new Supabase pro

supabase.com