Deploy Neon on Azure

Neon is available on the Azure Marketplace as an Azure Native ISV Service, allowing you to work with Neon the same way you work with other native solutions from Microsoft.

This guide steps you through deploying Neon as an Azure native service.

Prerequisites

• Azure account: If you don't have an active Azure subscription, create a free account.
• Access level: Only users with Owner or Contributor access roles on the Azure subscription can set up the integration. Ensure you have the appropriate access before proceeding. For information about assigning roles in Azure, see Steps to assign an Azure role.

Find Neon on Azure and subscribe

1. Use the search bar at the top of the Azure portal to find the Neon Serverless Postgres offering.

   

   Alternatively, go to the Azure Marketplace and search for Neon Serverless Postgres.

2. Subscribe to the service. You will be directed to the Create a Neon Serverless Postgres Resource page.

Create a Neon Resource

1. On the Create a Neon Serverless Postgres Resource page, enter values for the properties described below.

   Property	Description
   Subscription	From the drop-down, select an Azure subscription where you have Owner or Contributor access.
   Resource group	Select an existing Azure resource group or create a new one. A resource group is like a container or a folder used to organize and manage resources in Azure. For more information, see Azure Resource Group overview.
   Resource Name	Enter a name for the Azure resource representing your Neon organization. This name is used only in Azure.
   Region	Select a region to deploy your Azure resource. This is the region for your Azure resource, not for your Neon projects and data. You will select from Azure-supported regions when you create the Neon project in a later step. For example, you can create a Neon resource in the (US) West US 3 region and create a Neon project (Europe) Germany West Central.
   Neon Organization name	Provide a name for your Neon Organization, such as a team name or company name. The name you specify will be your Organization name in the Neon Console. Your Neon projects will reside in this named organization.
   Plan	Select a plan. You have three to choose from: Free, Scale, and Business. Select Change Plan to view details about each plan. For more information about Neon's plans, please refer to the Neon Pricing page. The Neon Launch Plan is currently not available in the Azure Marketplace.
   Billing term	Select a billing term for the selected plan. You can choose from a 1-Month or a 1-Year billing term (monthly or yearly billing).

   

2. Review your Price + Payment options and Subtotal, select Next.

3. On the Project page, enter a name for your Neon project, select a Postgres version, specify a name for your database, and choose a region. We recommend selecting the region closest to your application.

   

   note

   A Neon organization created via the Azure portal supports creating Neon projects in Azure regions only. Neon's AWS regions are not supported with Neon on Azure.

4. Click Next.

5. Optionally specify tags for your resource, then click Next. For more about tags, see Use tags to organize your Azure resources.

6. On the Review + Create page, review your selections, the Azure Marketplace Terms, and the Neon Terms of Use and Privacy Policy.

7. Select Create to initiate the resource deployment, which may take a few moments.

8. When your deployment is complete, click the Go to resource button under Next steps to view your new Neon resource.

   

9. Select the Go to Neon link under Getting started to open the Neon Console.

   

   You will be directed to the Neon Console where you can start working with your newly created Neon organization and project.

   

10. From here, follow the Neon Getting Started guide to begin working with your Neon project and get familiar with the platform.

Create Neon projects in Azure regions without the integration

If you want to deploy a Neon project to an Azure region without using the Azure Native ISV Service integration, you can simply select one of our supported Azure regions when creating a Neon project from the Neon Console.

If you do not use the Azure integration, there is no difference from a Neon project created in an AWS region—your Neon project simply resides in an Azure region instead of AWS region.

You might consider this option if:

• Part of your infrastructure runs on Azure but you don't need the native integration
• An Azure region is closer to your application than a Neon AWS region
• You want to manage billing through Neon rather than Azure

Creating a Neon project in an Azure region without using the Azure Native ISV Service is supported via the Neon Console, CLI, and API.

ConsoleCLIAPI

To create a Neon project from the console, follow the Create project steps. Select Azure as the Cloud Service Provider, and choose one of the available Azure regions.