Quick start

Get started in less than 5 minutes in the cloud or on your desktop

The quickest way to get started with YugabyteDB Aeon is to create a free Serverless Postgres cluster. Serverless Postgres is free up to 2 vCPU and 16 GiB of memory, and no credit card is required.

  1. Sign up.

  2. Log in.

  3. Click Start free. (If you don't see the Start free option, select the Clusters page, then click Explore Cluster Types.)

    This displays the Create Postgres Cluster dialog with settings already selected:

    • Cluster name
    • Engine, region, and compute
    • Your IP address added as a trusted IP so that you will be able to connect to the cluster from your machine
    • Database credentials.

  4. Click Download Credentials to download the credentials file to your machine. You will use these to connect to your database.

  5. Click Create Cluster.

    When finished, your cluster is listed on the Clusters page.

  6. Select the cluster to open it.

Free serverless cluster

The first time you create a cluster, YugabyteDB Aeon creates the Serverless account in your organization. This account is used for all your serverless clusters.

Connect to the cluster

A new cluster has one read-write endpoint on the main branch. Clients can connect through a public endpoint limited by trusted IP addresses. In this case, you provided the address of your own machine when creating the free cluster.

Connect to your cluster's endpoint using psql:

  1. Under the main branch Compute Endpoints, click Connect.

  2. If the dialog offers Download CA Cert, click it and save the certificate.

  3. Click Copy to copy the connection string. The host and port are the endpoint's address. In the copied string, do the following:

    • Replace <DB USER> with your database username (admin unless you created another role).
    • Replace postgres if you're connecting to a database other than the default.
    • Replace <ROOT_CERT_PATH> with the path to the CA certificate you downloaded. If the endpoint doesn't require the CA certificate, the string has no sslmode or sslrootcert.

    If the endpoint has a DocumentDB address, the dialog also offers DocumentDB. Select it and copy that command instead.

  4. Run the command. When prompted, enter the password from the credentials file.

You can now run SQL against your Serverless Postgres database, and connect applications using any PostgreSQL driver.

Serverless Postgres
Fully managed PostgreSQL for any workload, from a single application to fleets of databases. Free up to 2 vCPU.
Learn more
Distributed Postgres
Deploy single- and multi-region YugabyteDB clusters on Amazon Web Services (AWS), Microsoft Azure, and Google Cloud Platform (GCP).
Learn more