--- title: "Organization Workspaces" description: "A workspace is a directory that contains a data directory, a Lean configuration file, and all your project files." canonical: https://www.quantconnect.com/docs/v2/local-platform/development-environment/organization-workspaces markdown: https://www.quantconnect.com/docs/v2/local-platform/development-environment/organization-workspaces.md language: python source: https://github.com/QuantConnect/Documentation/tree/master/02%20Local%20Platform/04%20Development%20Environment/04%20Organization%20Workspaces modified: 2026-10-28 index: https://www.quantconnect.com/llms.txt --- # Organization Workspaces [Documentation](https://www.quantconnect.com/docs/v2.md) > [Local Platform](https://www.quantconnect.com/docs/v2/local-platform.md) > Development Environment > Organization Workspaces > Code examples are shown in Python. Append `?lang=csharp` to this URL for the C# version of this page. ## Introduction An organization workspace is a directory that contains a `data` directory, a Lean configuration file, and all your project files from one of your organizations. You can have a separate organization workspace directory for each organization you're a member of on QuantConnect. These directories need a `data` directory and a Lean configuration file in order to run the LEAN engine on your local machine. ## Pull Cloud Organization Workspaces Follow these steps to pull one of your [cloud organization workspaces](https://www.quantconnect.com/docs/v2/cloud-platform/projects/getting-started.md#02-View-All-Projects) and set it as your local organization workspace: 1. [Log in to Local Platform](https://www.quantconnect.com/docs/v2/local-platform/development-environment/authentication.md#02-Log-In). 2. In the left navigation menu, click the ![VS Code QuantConnect icon](https://cdn.quantconnect.com/i/tu/vscode-qc-icon.jpg) **QuantConnect** icon. 3. In the Select Workspace panel, click **Pull Organization Workspace**. ![Select workspace](https://cdn.quantconnect.com/i/tu/select-workspace.png) 4. In the Pull QuantConnect Organization Workspace window, click the cloud workspace ([organization](https://www.quantconnect.com/docs/v2/cloud-platform/organizations.md)) that you want to pull. ![Pull cloud organization](https://cdn.quantconnect.com/i/tu/pull-cloud-workspaces-1.png) 5. In the Pull QuantConnect Organization Workspace window, create a directory to serve as the organization workspace and then click **Select**. ![Pull cloud workspace](https://cdn.quantconnect.com/i/tu/pull-cloud-workspaces-2.png) It takes a few minutes to create a new organization workspace directory and populate it with the [the initial file structure](https://www.quantconnect.com/docs/v2/local-platform/development-environment/organization-workspaces.md#07-Directory-Structure). After the organization workspace is populated with the initial file structure, it pulls [your cloud project files](https://www.quantconnect.com/docs/v2/cloud-platform/projects/getting-started.md#02-View-All-Projects). If you are running Docker on Windows using the legacy Hyper-V backend instead of the new WSL 2 backend, you need to enable file sharing for your temporary directories and for your organization workspace. To do so, open your Docker settings, go to **Resources > File Sharing** and add `C: / Users / / AppData / Local / Temp` and your organization workspace path to the list. Click **Apply & Restart** after making the required changes. ## Change Organization Workspaces Follow these steps to change organization workspaces: 1. [Log in to Local Platform](https://www.quantconnect.com/docs/v2/local-platform/development-environment/authentication.md#02-Log-In). 2. In the left navigation menu, click the ![VS Code QuantConnect icon](https://cdn.quantconnect.com/i/tu/vscode-qc-icon.jpg) **QuantConnect** icon. 3. If a project is already open, [close it](https://www.quantconnect.com/docs/v2/local-platform/projects/getting-started.md#05-Close-Projects). 4. In the Open Project panel, click **Change**. ![Change workspace panel](https://cdn.quantconnect.com/i/tu/local-platform-change-workspaces.png) 5. [Pull a cloud workspace](https://www.quantconnect.com/docs/v2/local-platform/development-environment/organization-workspaces.md#03-Pull-Cloud-Organization-Workspaces). ## Directory Structure The organization workspace directory initially has following structure: ``` . ├── data/ │   ├── alternative/ │   ├── crypto/ │   ├── equity/ │   ├── ... │   ├── market-hours/ │   ├── option/ │   ├── symbol-properties/ │   └── readme.md │── storage/ └── lean.json ``` These files contain the following content: | File/Directory | Description | | --- | --- | | `data /` | This directory contains the local data that LEAN uses to run locally. This directory is comes with [sample data from the QuantConnect/Lean repository](https://github.com/QuantConnect/Lean/tree/master/Data). As you [download additional data](https://www.quantconnect.com/docs/v2/lean-cli/datasets/quantconnect.md) from the dataset market, it's stored in this directory. Each organization workspace has its own `data` directory because each organization has its own data licenses. | | `storage /` | This directory contains the [Object Store](https://www.quantconnect.com/docs/v2/lean-cli/object-store.md) data that LEAN uses to run locally. | | `lean.json` | This file contains the Lean configuration that is used when running the LEAN engine locally. The configuration is stored as JSON with support for both single-line and multiline comments. The Lean configuration file is based on the [Launcher/config.json](https://github.com/QuantConnect/Lean/blob/master/Launcher/config.json) file from the Lean repository. When you create a new organization workspace, the latest version of this file is downloaded and stored on your local drive. | As you add [projects](https://www.quantconnect.com/docs/v2/local-platform/projects/getting-started.md), the project files are added to your organization workspace directory. If you create and use [shared libraries](https://www.quantconnect.com/docs/v2/local-platform/projects/shared-libraries.md) in your projects, the library files are added to a `Library` directory in your organization workspace.