---
title: "lean cloud pull"
description: "API reference for the command `lean cloud pull` in command line console."
canonical: https://www.quantconnect.com/docs/v2/lean-cli/api-reference/lean-cloud-pull
markdown: https://www.quantconnect.com/docs/v2/lean-cli/api-reference/lean-cloud-pull.md
language: python
source: https://github.com/QuantConnect/Documentation/tree/master/05%20Lean%20CLI/99%20API%20Reference/17%20lean%20cloud%20pull
modified: 2026-10-29
index: https://www.quantconnect.com/llms.txt
---

# lean cloud pull

[Documentation](https://www.quantconnect.com/docs/v2.md) > [Lean CLI](https://www.quantconnect.com/docs/v2/lean-cli.md) > [API Reference](https://www.quantconnect.com/docs/v2/lean-cli/api-reference.md) > lean cloud pull

> Code examples are shown in Python. Append `?lang=csharp` to this URL for the C# version of this page.

## Introduction

Pull projects from QuantConnect to the local drive.

```
$ lean cloud pull [OPTIONS]
```

To use the CLI, you must be a member in an [organization](https://www.quantconnect.com/docs/v2/cloud-platform/organizations/tier-features.md) on a paid tier.

## Description

Pulls projects from QuantConnect to your local directory while preserving the directory structure of your projects on QuantConnect. The project's files, description, and parameters are pulled from the cloud. By default, all cloud projects are pulled from the organization that's linked to your current [organization workspace](https://www.quantconnect.com/docs/v2/lean-cli/initialization/organization-workspaces.md). If you provide a `--project` option, you only pull a single project from the cloud.

Before pulling a cloud project, the CLI checks if the local directory with the same path already exists. If it does and the local directory is not linked to the cloud project (because of an earlier `lean cloud pull` or `lean cloud push`), the CLI skips pulling the cloud project and logs a descriptive warning message.

If you have a local copy of a project when you pull it from the cloud, local files that don't exist in the cloud are not deleted, but the configuration values of your cloud project overwrite the [configuration values of the local version](https://www.quantconnect.com/docs/v2/lean-cli/projects/configuration.md#02-Properties). If you have renamed the project in the cloud, when you pull the project from the cloud, the local project is renamed to match the name of the cloud project.

If one of your team members creates a [project library](https://www.quantconnect.com/docs/v2/lean-cli/projects/libraries/project-libraries.md), adds it to a project, and then adds you as a collaborator to the project, you can pull the project but not the library. To pull the library as well, your team member must add you as a collaborator on the library project.

## Options

The `lean cloud pull` command supports the following options:

| Option | Description |
| --- | --- |
| `--project <string>` | Name or id of the project to pull (all cloud projects if not specified) |
| `--pull-bootcamp` | Pull Boot Camp projects (disabled by default) |
| `--encrypt` | Pull your cloud files and encrypt them before saving on your local drive |
| `--decrypt` | Pull your cloud files and decrypt them before saving on your local drive |
| `--key <file>` | Path to the encryption key to use |
| `--verbose` | Enable debug logging |
| `--help` | Display the help text of the `lean cloud pull` command and exit |