Skip to main content

Creating Your First Project

This tutorial walks you through setting up your first Dremio Cloud project.


Before you begin, sign up for Dremio Cloud and verify that you meet the prerequisites for configuring a Sonar project. After you’ve signed up, you’ll be logged into your organization and navigated to your organization homepage.

This is a screenshot showing the organization homepage.

You can now get started with adding a Sonar project.

Add a Sonar Project

After you have signed up for Dremio Cloud (see Prerequisites for details), follow these steps to create your first Sonar project:

  1. On your organization homepage, click Add Sonar Project on the Sonar card.

  2. In the Add Sonar Project dialog, for Project name, specify a name to identify your project. You can change the name of the project after creation.

  3. For Arctic catalog name, specify a name to identify the primary catalog in your project. The name cannot be changed once the catalog has been created.

  4. For AWS Region, select the region in which compute resources and the project store will be created. For a list of supported regions, see Supported Regions.

  5. (Optional) For AWS Tags, add one or more AWS tags to help you identify compute resources for this project in your AWS account.

  6. Click Next to continue the configuration.

  7. Click Launch CloudFormation Template, which will open the AWS Console in a new browser tab.


    The CloudFormation template is the recommended method for configuring project resources. For more information on the resources being created and the permissions granted to Dremio, see the annotated CloudFormation Template.

    To manually create cloud and project resources, click the link at the bottom of the Add Sonar Project dialog and see Configuring Your Cloud Resources Manually.

  8. On the “Quick create stack” page in the AWS Console, for Stack name, enter a name to identify the stack. This name must be unique to your AWS account and cannot include underscores.

  9. For VPC, select the VPC in which compute resources will be created.

  10. For Subnets, select one or more subnets where compute resources will be created.

  11. For Project Store, a unique name has been generated for the S3 bucket that will be created in your AWS account as the metadata store for your project. You can specify a different name here but it must be unique across AWS.

  12. For Encryption Type, SSE-S3 is the default encryption mechanism for the project store S3 bucket. You can select SSE-KMS (AWS Managed Key) or SSE-KMS (Customer Managed Key) for additional encryption. If you select SSE-KMS (Customer Managed Key), specify the KMS Key ARN.

  13. Acknowledge by checking the box: I acknowledge that AWS CloudFormation might create IAM resources.

  14. Click Create stack.

    It will take about five minutes to create the required storage and compute resources for the project.


    If you encounter errors during resource creation, see Dremio Cloud Troubleshooting for AWS.

When stack creation has completed in the AWS Console, return to the Dremio Console and you're ready to start analyzing data!

Wrap-up & Next Steps

You're done setting up your Dremio Cloud account! Learn more about how you can quickly create a semantic layer and optimize your queries with the Getting Started with Dremio tutorial.

You can also preview going from natural language to SQL with a single click with the Analyze Data Using Text-to-SQL tutorial.

Have Questions?

If you have questions about the concepts in this tutorial or other Dremio features, reach out to us using the chat feature This is the icon that represents the Intercom chat. in the bottom-right corner of the Dremio application.