Configure and deploy your cluster

After having subscribed to the Microsoft Azure Marketplace offer, you can now start to deploy your first cluster by going through the CrateDB Cloud Console configuration wizard. Here we will walk you through the process.

Table of contents


To recap from the previous tutorial: to deploy your cluster, first it must be configured. If you have not yet done so, go to the Azure Portal’s Home > (SaaS) page. Inside it, select the subscription you created. Now click on Configure Account on the Overview menu.

Azure SaaS configuration screen

You’ll now be redirected to the CrateDB Cloud Console.

Once in the Console, authenticate with the Azure account you used to create the offer in the previous step. (If you are authenticated with a different account, a warning message will appear, directing you to log out and to log in with your Azure account instead.) Select Sign in with Azure AD and continue.

Now complete the three-step wizard to deploy the cluster.


Wizard step 1

In this step, you must first define an organization, if you have not already done so. (If you have, it will be pre-selected for you.) You must also select a region for your project (within which the cluster will be deployed), and either name a new project or choose an existing one if you have one.

CrateDB Cloud configuration wizard step 1

You may also notice a popup in the right bottom corner. This is to welcome you after your signup to CrateDB Cloud. In it, you will find a link to our help document on cluster deployment, which provides a quick summary of the same process described in this tutorial. If you want, you can also reply to it. This puts you in contact with the team.

Fill out the required lines and click Next to continue.

Wizard step 2

In the second step of the CrateDB Cloud Console configuration wizard, you can define your cluster name. You must also set the username and password used to directly access the cluster via its URL. The password must be at least 24 characters long; any characters are accepted, including special characters. If you want, click the Auto-generate password button to automatically generate a secure 24 character password.

CrateDB Cloud configuration wizard step 2

Finally, you can also set the scale unit of the cluster to the desired level here. As you move the slider horizontally, you will move up (or down) the scale levels within the subscription plan you previously selected. As you will see, the hardware capacities of the cluster will change correspondingly. Currently, within each subscription plan clusters can be scaled between scale units 1-3. The default scale unit is 1. Note that scaling the cluster changes its price.

Do not worry, however: clusters can be scaled up or down as needed - for example if your use case changes - at any point later on. To understand more about subscription plans, scaling, and scale units, refer to our reference on subscription plans and our scaling guide.

When you have filled out the required lines and chosen a scale unit, click Next to proceed.

Wizard step 3

The final step of the configuration wizard provides you with a summary of your previous choices and the overall result. First, it shows the settings for your organization and project, with the names you have defined. Next, it shows the cluster information, including the version of CrateDB the cluster will be running and once again the scale unit capacities the cluster will have. Finally, the pricing information shows you the relevant costs of running the cluster. Note that always bills for usage on an hourly basis, and only actual usage is ever billed.

CrateDB Cloud configuration wizard step 3

Take a moment to review. If you are satisfied, click Deploy, and the cluster will be deployed. Eventually, you will be forwarded to the CrateDB Cloud Console.

Deploy and connect

A popup menu will remind you of the username and password you selected for connecting to the cluster. Make sure you copy this information to a safe place (e.g., a password manager), as it will not be retrievable past this point.

The new cluster should be visible inside the project where you created it in the left hand menu. Please keep in mind that the deployment can take some time depending on the size of the cluster. Usually it takes about 10 to 20 minutes.

To test if your cluster is available, go to Cluster Overview in the Console and click on the cluster URL. Once the cluster is up and running you should be presented with a login form. Enter the database user and password defined in step 2 of the wizard. After authentication the CrateDB Admin UI opens and you can start using your cluster. For more information, visit our Help page.


How helpful was this page?