Create an Azure Cosmos DB for PostgreSQL cluster in the Azure portal

APPLIES TO: Azure Cosmos DB for PostgreSQL (powered by the Citus database extension to PostgreSQL)

Azure Cosmos DB for PostgreSQL is a managed service that allows you to run horizontally scalable PostgreSQL databases in the cloud.

Prerequisites

If you don't have an Azure subscription, create a free account before you begin.

Create a cluster

Sign in to the Azure portal and follow these steps to create an Azure Cosmos DB for PostgreSQL cluster:

Direct link

Go to Create an Azure Cosmos DB for PostgreSQL cluster in the Azure portal.

Portal search

1. In the Azure portal, search for cosmosdb and select Azure Cosmos DB from the results.

   

2. On the Azure Cosmos DB screen, select Create.

   

3. On the Select API option screen, select Create on the PostgreSQL tile.

   

On the Create an Azure Cosmos DB for PostgreSQL cluster form:

1. Fill out the information on the Basics tab.

   

   Most options are self-explanatory, but keep in mind:

   • The cluster name determines the DNS name your applications use to connect, in the form <clustername>.postgres.database.azure.com.
   • You can choose a database version. Azure Cosmos DB for PostgreSQL always supports the latest PostgreSQL version, within one day of release.
   • The admin username must be the value citus.

2. Select Next : Networking at the bottom of the screen.

3. On the Networking screen, select Allow public access from Azure services and resources within Azure to this cluster.

   

4. Select Review + create, and when validation passes, select Create to create the cluster.

5. Provisioning takes a few minutes. The page redirects to monitor deployment. When the status changes from Deployment is in progress to Your deployment is complete, select Go to resource.

Next step

With your cluster created, it's time to connect with a SQL client.

Connect to your cluster >