> For the complete documentation index, see [llms.txt](https://boomi.markusschmidt.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boomi.markusschmidt.pro/boomi-console/installation/setup-a-workspace-and-connect.md).

# 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>