Manage Neon on Azure

This topic describes how to manage your Neon resource on Azure. It covers how to create additional Neon projects, how to transfer Neon projects to an Azure-created Neon organization, how to delete a Neon resource, and troubleshooting.

Create additional Neon projects

All Neon plans, including the Free plan, support multiple Neon projects. You can add Neon projects to an existing Neon resource from the Projects page in Azure or from the Neon Console.

In Azure, navigate to the Projects page and select Create Project.

See Create a project for how to create a project from the Neon Console.

Create branches

A branch is an independent copy of your database that you can use for development or testing. It will not increase storage until you modify data or the branch falls out of your project's restore window. Changes made on a branch do not affect the parent database. To learn more, see Branching.

To create branches in the Azure Portal:

1. Navigate to your Neon resource and select the Projects page.

2. Select your Neon project. You should see your existing branches.

3. To create a new branch, select Create branch to open the Create new Branch drawer.

4. Specify a branch name and select a parent branch, and click Create.

You now have an independent and isolated copy of your parent branch with its own compute resources.

The branch page shows the following information for each branch:

To learn about integrating branching into your developer workflow, see our Database branching workflow primer.

You can also create branches in the Neon Console. See Create a branch for instructions.

Delete branches

Important points about branch deletion:

• A branch deletion action cannot be undone.
• You cannot delete a branch that has children. You need to delete the child branches first.

To delete a branch in the Azure Portal:

1. Navigate to your Neon resource.
2. Select your Neon project. You should see your existing branches.
3. Select the branch you want to delete.
4. Select Delete Neon branch to open the Delete Branch drawer. You'll need to type the branch name to enable the Delete button.
5. Click Delete and confirm.

You can also delete branches in the Neon Console. For instructions, see Delete a branch.

Connect to a database

You can connect to your Neon database using a Postgres database connection URL.

To retrieve a connection URL for your Neon database:

1. Navigate to your Neon resource.

2. Select Settings > Connect.

3. On the Connect page, use the drop-down menus to select a Neon Project, Branch, Database, Role, and Compute.

   

   The values you select define the connection string for your database:

   Value	Description
   Project	The Neon project you want to connect to. A Neon project includes databases and branches.
   Branch	A branch within your Neon project where your database resides.
   Database	The name of the Postgres database you want to connect to.
   Role	The Postgres role (user) you want to connect with.
   Compute	The compute that runs Postgres. Usually "Primary"—this is the read-write compute for the branch, but you may also have read replica computes.

You can toggle the Connection pooling option to use a pooled connection string, which supports up to 10,000 concurrent connections. A pooled connection string is recommended for most use cases. Use a direct connection for pg_dump, session-dependent features, or schema migrations. For more about pooled connections, see Connection pooling.

For more about connecting to your Neon database, see Connect from any app.

Transfer projects to an Azure-created Neon organization

You can transfer existing Neon projects to an Azure-created organization, but note these restrictions:

• The Neon project you are transferring must belong to a personal Neon account, not an organization.
• The Neon project you are transferring must be in an Azure region. Azure-created Neon organizations do not support projects created in AWS regions.
• The billing plan of the Azure-managed organization must match or exceed the billing plan of the personal Neon account you are transferring projects from. For example, attempting to transfer projects from a Neon paid plan personal account to a Free plan Azure-managed organization will result in an error.

For detailed transfer steps, see Transfer projects to an organization.

If the restrictions above prevent you from transferring your project, consider these options:

• Open a support ticket for assistance with transferring your Neon project (supported only for projects that reside in Azure regions). If you're on the Neon Free Plan and can't open a support ticket, you can email Neon support at support@neon.tech.
• Create a new Neon project in an Azure-managed organization and migrate your database using one of these options:
  • Neon Import Data Assistant
  • pg_dump and pg_restore

Delete a Neon Resource in Azure

If you no longer need your Neon resource, you can delete it to stop all associated billing through the Azure Marketplace.

Follow these steps to delete the resource:

1. In the Azure portal, select the Neon resource you want to delete.
2. On the Overview page, select Delete.
3. Confirm the deletion by entering the resource's name.
4. Choose the reason for deleting the resource.
5. Select Delete to finalize.

Once the resource is deleted, billing will stop immediately, and the Neon Organization and all Neon projects and data associated with that resource will be removed.

Troubleshoot

If you encounter issues, check the documentation in Azure's troubleshooting guide for Neon: Troubleshoot Neon Serverless Postgres. If you still need help, contact Neon Support.