# Creating a Workspace

In this guide, you'll learn all the essential steps to create a Paradime workspace, the foundation for your dbt™ development journey. A well-configured workspace is crucial for efficient collaboration and streamlined analytics engineering processes.

**Estimated completion time:** 10 minutes

{% hint style="warning" %}

### Prerequisites

* An [**admin role**](https://docs.paradime.io/app-help/documentation/settings/users/role-based-access-control) In Paradime to create workspaces
* Repository admin access to add a deploy key for your [**Git repository**](https://docs.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository)
* Access credentials for your [**data warehouse**](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment)
  {% endhint %}

### What You'll Learn

In this guide, you'll learn how to:

1. [Create a Paradime workspace](#id-1.-creating-a-paradime-workspace)
2. [Connect a Git Repository](#id-2.-connect-a-git-repository-to-the-workspace)
3. [Add a Data warehouse connection](#id-3.-add-a-data-warehouse-connection)

***

### Video Tutorial

The following video provides step-by-step instructions for creating a workspace, connecting a Git repository, and setting up a data warehouse connection:

{% embed url="<https://www.youtube.com/watch?feature=youtu.be&v=ONAqHL8t6wQ>" %}

### 1. Creating a Paradime Workspace

To create a workspace in Paradime:

1. Navigate to your Platform settings.
2. Click the `New Workspace` button to begin setting up your workspace.
3. Provide a name for your workspace.
4. Choose whether you want other people in your organization to access it without an invite (with a business user role). This option makes the workspace visible in the workspaces list to users, even if they're not yet part of it.

***

### 2. Connect a Git Repository to the Workspace

Next, connect a Git repository to Paradime:

* This can be an empty repository or an existing dbt™ project.
* Upon adding a repository SSH URI, Paradime will generate a deploy key.
* Use this deploy key to grant Paradime write access to the repo, allowing users to create commits and push branches from the Paradime IDE.

{% hint style="info" %}
**Note:** You must be a repository admin to add a deploy key. Paradime supports [GitHub](https://docs.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository/github), [GitLab](https://docs.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository/gitlab), [Azure Repos](https://docs.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository/azure-devops), and [Bitbucket](https://docs.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository/bitbucket).
{% endhint %}

***

### 3. Add a Data Warehouse Connection

Finally, add a data warehouse connection during the workspace onboarding:

* This enables developing and running dbt models via the Paradime IDE.
* Paradime supports many [warehouse providers](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment), including:
  * [Snowflake](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment/snowflake)
  * [BigQuery](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment/bigquery)
  * [Redshift](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment/redshift)
  * [Databricks](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment/databricks)
* Multiple authentication methods are available based on your needs.

***

{% hint style="info" %}
Related Documentation:

* [Setting up Data Warehouse Connections](https://docs.paradime.io/app-help/documentation/settings/connections/development-environment)
* [Managing workspace configurations](https://docs.paradime.io/app-help/documentation/settings/workspaces)
* [Importing a Git Repository](https://docs.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository)
  {% endhint %}

***

### Summary

You've successfully created your Paradime workspace, which serves as the foundation for your dbt™ development. Here's what you've accomplished:

1. Created a new workspace in Paradime
2. Connected a Git repository to your workspace
3. Set up an initial data warehouse connection

In the next guide, we'll explore [how to configure additional data warehouse connections](https://docs.paradime.io/app-help/guides/paradime-101/getting-started-with-your-paradime-workspace/setting-up-data-warehouse-connections) for development, testing, and production environments.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.paradime.io/app-help/guides/paradime-101/getting-started-with-your-paradime-workspace/creating-a-workspace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.