docs/content/stable/quick-start-yugabytedb-managed/_index.md
Use a cloud cluster
</a>
Use a local cluster
</a>
The quickest way to get started with YugabyteDB is to create a free Sandbox cluster in YugabyteDB Aeon:
The first time you log in, YugabyteDB Aeon provides a welcome experience with a 15 minute guided tutorial. Complete the steps in the Get Started tutorial to do the following:
{{< sections/2-boxes >}} {{< sections/bottom-image-box title="Docs" description="Learn how to deploy and manage clusters in YugabyteDB Aeon." buttonText="YugabyteDB Aeon documentation" buttonUrl="/stable/yugabyte-cloud/"
}}
{{< sections/bottom-image-box title="FAQ" description="Get answers to questions about YugabyteDB Aeon." buttonText="YugabyteDB Aeon FAQ" buttonUrl="/stable/faq/yugabytedb-managed-faq/"
<!-- Following sections are duplicated in cloud-quickstart -->}} {{< /sections/2-boxes >}}
If you aren't using the Get Started tutorial, use the following instructions to create a cluster, connect to your database, explore distributed SQL, and build an application.
The Sandbox cluster provides a fully functioning single node YugabyteDB cluster deployed to the region of your choice. The cluster is free forever and includes enough resources to explore the core features available for developing applications with YugabyteDB. No credit card information is required.
Sandbox cluster
YugabyteDB is a distributed database optimized for deployment across a cluster of servers. The Sandbox cluster has a single node and limited resources, suitable for running tutorials, Yugabyte University, and building sample applications. See Differences between Sandbox and Dedicated clusters for more information.
To evaluate YugabyteDB Aeon for production use or conduct a proof-of-concept (POC), contact Yugabyte Support for trial credits.
To create your Sandbox cluster:
Click Create Cluster on the welcome screen, or click Add Cluster on the Clusters page to open the Create Cluster wizard.
Select Sandbox and click Choose.
Enter a name for the cluster, choose the cloud provider (AWS or GCP), and choose the region in which to deploy the cluster, then click Next.
Click Add Current IP Address. The IP address of your machine is added to the IP allow list. This allows you to connect to your sandbox cluster from applications and your desktop after it is created.
Click Next.
Click Download credentials. The default credentials are for a database user named "admin". You'll use these credentials when connecting to your YugabyteDB database.
Click Create Cluster.
YugabyteDB Aeon bootstraps and provisions the cluster, and configures YugabyteDB. The process takes around 5 minutes. While you wait, you can optionally fill out a survey to customize your getting started experience.
When the cluster is ready, the cluster Overview is displayed. You now have a fully configured YugabyteDB cluster provisioned in YugabyteDB Aeon.
Use Cloud Shell to connect to your YugabyteDB Aeon cluster from your browser, and interact with it using distributed SQL.
The shell has a one hour connection limit. If your session is idle for more than 5 minutes, it may disconnect. If your session expires, close your browser tab and connect again.
To connect to your cluster, do the following:
On the Clusters page, ensure your cluster is selected.
Click Connect to display the Connect to Cluster dialog.
Under Cloud Shell, click Launch Cloud Shell.
Enter the database name (yugabyte), the user name (admin), select the YSQL API type, and click Confirm.
Cloud Shell opens in a separate browser window. Cloud Shell can take up to 30 seconds to be ready.
Enter your DB password:
Enter the password for the admin user credentials that you saved when you created the cluster.
The shell prompt appears and is ready to use.
ysqlsh (15.2-YB-{{<yb-version version="stable">}}-b0)
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.
yugabyte=>
The command line interface (CLI) being used is called ysqlsh. ysqlsh is the CLI for interacting with YugabyteDB using the PostgreSQL-compatible YSQL API. Cloud Shell also supports ycqlsh, a CLI for the YCQL API.
For information on other ways to connect to your cluster, refer to Connect to clusters.
When you connect to your cluster using Cloud Shell with the YSQL API (the default), the shell window incorporates a Quick Start Guide, with a series of pre-built queries for you to run. Follow the prompts to explore YugabyteDB in 5 minutes.
Applications connect to and interact with YugabyteDB using API client libraries (also known as client drivers). This section shows how to connect applications to YugabyteDB Aeon clusters using your favorite programming language.
Before you begin, you need the following:
Refer to Before you begin.
{{< readfile "quick-start-buildapps-include.md" >}}
</details>For PostgreSQL users seeking to transition to a modern, horizontally scalable database solution with built-in resilience, YugabyteDB offers a seamless lift-and-shift approach that ensures compatibility with PostgreSQL syntax and features while providing the scalability benefits of distributed SQL.
YugabyteDB enables midsize applications running on single-node instances to effortlessly migrate to a fully distributed database environment. As applications grow, YugabyteDB seamlessly transitions to distributed mode, allowing for massive scaling capabilities.
YugabyteDB Voyager simplifies the end-to-end database migration process, including cluster setup, schema migration, and data migration. It supports migrating data from PostgreSQL, MySQL, and Oracle databases to various YugabyteDB offerings, including Aeon, Anywhere, and the core open-source database.
You can install YugabyteDB Voyager on different operating systems such as RHEL, Ubuntu, macOS, or deploy it via Docker or Airgapped installations.
Voyager provides a powerful migration assessment that scans your existing applications and databases. This detailed assessment provides valuable insights into the readiness of your applications, data, and schema for migration.
When you're ready to migrate, you can perform an offline migration; or do a non-disruptive live migration, with fall-forward and fall-back capabilities.
Deploy clusters in YugabyteDB Aeon
Connect applications to YugabyteDB Aeon