SSupabaseHelp Center

Guide

Create New Supabase Project

8 stepsAgent View (JSON)

Overview

Supabase is a Postgres development platform that provides a managed database, authentication, and APIs out of the box. Creating a new project provisions a dedicated PostgreSQL instance with its own API layer, allowing you to start building applications immediately without managing database infrastructure. Each project is isolated and includes full access to Postgres features, real-time subscriptions, and edge functions. This workflow is the first step for any new Supabase application.

Before you begin

  • A Supabase account (free tier available at supabase.com)
  • Access to the Supabase dashboard with an active organization
  • A strong password prepared for your database (minimum 8 characters recommended, including uppercase, lowercase, numbers, and special characters)

Step by step

1
ClickNew project

Navigate to the Supabase dashboard and click the 'New project' link in the top navigation or sidebar to begin the project creation flow.

Tip. If you have multiple organizations, ensure you are in the correct organization context before clicking 'New project'—the organization dropdown is typically visible in the top navigation.
Step 1
2
ClickBrowzer Labs, Inc. PRO New project Feedback Search... ⌘ K Create a new project Your project will have its own dedicated instance and full Postgres database. An API will be set up so you can easily interact with your new database. Organization Browzer

Review the project creation dialog that appears, confirming your organization is correct and understanding that your project will include a dedicated PostgreSQL database instance and auto-generated API.

Tip. The dialog displays your current organization (e.g., 'Browzer Labs, Inc.'). If you need to create the project in a different organization, close this dialog and switch organizations first.
Step 2
3
ClickProject name

Click the 'Project name' text field to focus it and prepare for entering your project name.

Step 3
4
TypeProject name

Type a descriptive name for your project (e.g., 'my-app-backend' or 'customer-portal'). This name will appear in your dashboard and help you identify the project later.

Tip. Use lowercase letters, numbers, and hyphens only. Avoid spaces and special characters for better compatibility. Consider including the environment (e.g., 'myapp-staging' vs 'myapp-production') if you plan multiple projects.
5
ClickType in a strong password

Click the 'Type in a strong password' field to focus it and prepare for entering your database password.

Tip. This password is for the 'postgres' database user and is displayed in plaintext here—make sure no one is looking over your shoulder when entering it.
Step 5
6
TypeType in a strong password

Type a strong, unique password for your Supabase PostgreSQL database. This password secures direct database access and is required for connections.

Tip. Generate a random password using a password manager and include at least 16 characters with a mix of uppercase, lowercase, numbers, and special characters ($, !, @, #). Store this password securely—you will need it to connect applications or tools to your database.
Warning. Do not use simple or common passwords, and do not reuse passwords from other accounts. Anyone with this password can access your database directly.
7
ClickCreate new project

Click the 'Create new project' button to submit the project creation request and initiate provisioning of your dedicated database instance.

Tip. Project provisioning typically takes 2–5 minutes. Do not refresh or navigate away during this time.
Step 7
8
ClickI understand

Click the 'I understand' button to acknowledge the confirmation dialog and finalize project creation.

Tip. This dialog often confirms that you understand billing implications (based on your plan) or terms of service. Read any message carefully before confirming.
Step 8

Confirm it worked

  1. 1You are redirected to the new project's dashboard after creation completes
  2. 2The project name appears in your organization's project list on the left sidebar
  3. 3A confirmation message or success indicator appears confirming the project was created
  4. 4The database connection details are accessible in your project's settings (you should see host, user, password fields populated)

Common issues

Keep reading

How to Create a Supabase Project for Beginners (2026 Step-by-Step Guide) - Steve Ronald

How to Create a Supabase Project for Beginners (2026 Step-by-Step Guide) - Steve Ronald # How to Create a Supabase Project for Beginners (2026 Step-by-Step Guide) Supabase is one of the best backend

steveronald.me

Supabase Fundamentals

Supabase Fundamentals No history yet # Introduction to Supabase ## What is Supabase? Supabase is a platform that gives developers all the backend services they need to build an application. Inste

oboe.com

Supabase | The Postgres Development Platform.

Supabase | The Postgres Development Platform. # Build in a weekendScale to millions Supabase is the Postgres development platform. Start your project with a Postgres database, Authentication, instan

supabase.link