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

# lean cloud push

[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 push

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

## Introduction

Push local projects to QuantConnect.

```
$ lean cloud push [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

Pushes local projects to QuantConnect while preserving the directory structure of your local projects. The project's [supported files](https://www.quantconnect.com/docs/v2/cloud-platform/projects/files.md#02-Supported-File-Types), description, and parameters are pushed to the cloud. By default, all local projects in your current organization workspace directory are pushed. If you provide a `--project` option, you only push a single project to the cloud.

Before pushing a local project, the CLI checks if the cloud project with the same path already exists. If it does and the cloud project is not linked to the local project (because of an earlier `lean cloud pull` or `lean cloud push`), the CLI adds a 1 to the end of the name of your local project and then pushes it to the cloud. If the cloud project doesn't exist yet, the CLI creates it for you and pushes the contents of the local project to the newly created cloud project.

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

## Options

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

| Option | Description |
| --- | --- |
| `--project <directory>` | Path to the local project to push (all local projects if not specified) |
| `--encrypt` | Push your local files and encrypt them before saving on the cloud |
| `--decrypt` | Push your local files and decrypt them before saving on the cloud |
| `--key <file>` | Path to the encryption key to use |
| `--force` | Force push even if there's a lock conflict |
| `--verbose` | Enable debug logging |
| `--help` | Display the help text of the `lean cloud push` command and exit |