# Setup a Workspace

To use *Boomi Console* you need a project [Workspace](/boomi-console/library/the-workspace.md) directory (per Boomi Account) where all the data is stored. I recommend using the *BoomiConsole* directory where you have installed the binaries and create a new directory called *`Workspace`.*

{% hint style="info" %}
If you want to connect **multiple accounts**, for example for consultants who work with several customers, it is recommended naming each workspace after the account and organising all workspaces in the same *BoomiConsole* root folder.
{% endhint %}

### Three Steps

1. **Collect information:** [Boomi Account Connection](/boomi-console/installation/setup-a-workspace-and-connect/boomi-account-connection.md)
2. **Open a console window** and navigate to your Workspace.
3. Initialize and connect your Workspace

{% tabs %}
{% tab title="Windows" %}
Use the `connect` batch-file to start the guided process. Use the **Console - not PowerShell!**

<div align="left" data-with-frame="true"><figure><img src="/files/Abh8YgipbRd2IxV83iiH" alt="" width="386"><figcaption></figcaption></figure></div>

{% hint style="info" %}
*Connect* is a batch file located in the Boomi Console binary directory. It will initialize the Workspace (if not yet done) and it'll guide you through the Boomi Account connection process.
{% endhint %}

* ...\Workspace> <mark style="color:$success;background-color:blue;">%bc\_dir%\connect</mark>

<figure><img src="/files/fsYTOlQyAW3YidWlEwJX" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Linux / Mac" %}
Linux or Max users must run the two steps manually:

* [Initialize Workspace](/boomi-console/installation/setup-a-workspace-and-connect/initialize-workspace.md)
* [Connect Workspace](/boomi-console/installation/setup-a-workspace-and-connect/connect-your-project-1.md)
  {% endtab %}
  {% endtabs %}

{% content-ref url="/pages/72Kjd56Ivfg8xFTw8kAo" %}
[Test Workspace](/boomi-console/installation/setup-a-workspace-and-connect/test-your-project.md)
{% endcontent-ref %}

<details>

<summary><mark style="color:red;">Google Drive spoiler!</mark></summary>

*<mark style="color:red;">**DO NOT USE Google Drive**</mark>*<mark style="color:red;">**&#x20;**</mark><mark style="color:red;">**to store your Workspace!**</mark>

Google Drive is not really compatible with Windows File System, and I encountered serious and strange issues. For example: I tried to create a directory and I got the message "*already exists*" and when I tried to navigate to there the message was "c*annot find directory*":

`md "g:\...\bc\Out"` -> A subdirectory or file *g:\\...\bc\Out* already exists.\
`cd "g:\...\bc\Out"` -> The system cannot find the path specified.

</details>


---

# 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://boomi.markusschmidt.pro/boomi-console/installation/setup-a-workspace-and-connect.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.