connect-cloud.md

Connect to your cloud environment

Polars Cloud requires connection to your AWS environment to execute queries. After account registration, you'll set up an organization that manages connected workspaces and team access.

Workspace setup

When you first access the Polars Cloud dashboard with a new account, you'll see a notification indicating your environment requires AWS connection. While you can explore the interface in this state, executing queries requires completing the setup process.

The setup process begins with naming your workspace. The default "Personal Workspace" works for individual use, but consider using team or project names for collaborative environments. This workspace name becomes part of your compute context configuration for remote query execution.

!!! tip "Naming your workspace"

If you’re unsure, you can use a temporary name. You can change the workspace name later under the workspace settings.

AWS infrastructure deployment

The deployment process uses a CloudFormation template to provision the necessary IAM roles and permissions in your AWS environment. This creates the setup that allows Polars Cloud to execute queries.

For detailed information about the AWS resources and architecture, see the AWS Infrastructure page.

!!! info "CloudFormation permissions"

Users without CloudFormation deployment permissions can easily share the deployment URL with their operations team or AWS administrators.

CloudFormation stack deployment typically completes within 5 minutes. You can monitor progress through either the AWS console or the Polars Cloud setup interface for real-time status updates.

Upon successful deployment, the setup confirms completion and provides access to the full Polars Cloud dashboard for immediate query execution.

You can now run your Polars queries remotely in the cloud. Go to the getting started section to your first query in minutes, learn more how to run queries remotely or manage your workspace to invite your team.

!!! info "One-time workspace setup"

Cloud environment connection is required once per workspace. Team members invited to connected workspaces can immediately execute remote queries without additional setup.

Start your next project

With your workspace connected to AWS, you can execute Polars queries remotely. Consider these next actions:

• Run your first remote query with the getting started guide

• Learn about compute context configuration for performance optimization

• Invite team members to your connected workspace to collaborate on your next project.