Edit

Share via


Quickstart: Create a Neon Serverless Postgres resource

This quickstart shows you how to create a Neon Serverless Postgres resource by using the Azure portal.

Prerequisites

Create a resource

Begin by signing in to the Azure portal.

  1. In the Azure portal, in the search bar, enter the name of the service.

  2. In the Services search results, choose the service.

  3. Select the + Create option.

The pane for creating a resource appears with the Basics tab open by default.

Basics tab

The Basics tab has sections for details about the project, the Azure resource, and the Neon organization. Red asterisks identify required settings.

Screenshot of the Azure portal that shows the Basics tab to create a new Neon resource.

  1. Under Project details, enter these values:

    Setting Action
    Subscription Select a subscription from your existing subscriptions.
    Resource group Use an existing resource group or create a new one.
  2. Under Azure Resource details, enter these values:

    Setting Action
    Resource name Specify a unique name for the resource.
    Region Select a region to deploy your resource.
  3. Under New Organization details, enter these values:

    Setting Action
    Organization name Specify a name for the organization.
    Plan Select the Change Plan link and choose the plan that you want.

    The remaining settings update themselves to reflect the details of the plan that you selected for this new organization.

  4. Select Next.

Project tab

In Neon, everything starts with a project: the top-level object in the Neon object hierarchy. When you create a project, a default branch and database are automatically created for your project to help you get started.

Screenshot of the Azure portal that shows the Project tab for a Neon resource.

On the Project tab, enter the values for each setting, or continue with the default values for your project.

Setting Action
Project name Specify a name for your Neon project.
Postgres version Choose a Postgres version for your project.
Database name Specify a name for your first database in the project.
Project region Choose the region for your database.

Note

The Project region value on this pane corresponds to your database. Don't confuse this value with the Region value from the Basics tab, which is where your Azure resource is deployed.

Tags tab (optional)

You can optionally create tags for your resource. Then select Review + create.

Review + create tab

If the review finds no errors, the Create button is enabled. Select it.

If the review identifies errors, a red dot appears next to each section where errors exist. To fix errors:

  1. Open each section that has errors and fix the errors.

    Fields with errors are highlighted in red.

  2. Select Review + create again.

  3. Select Create.

The message "Deployment is in progress" appears. When the deployment is complete, the message "Your deployment is complete" appears.

After the resource is created, select Go to Resource to view your resource.

Next step