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

# lean private-cloud start

[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 private-cloud start

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

## Introduction

Start a new private cloud

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

Starts a new private cloud deployment in a Docker container. Run with `--master` to start the node as a master server, or `--slave` to start it as a slave node connected to an existing master. Use `--token`, `--master-domain`, and `--master-port` to configure the connection between master and slave nodes.

Use `--compute` to select a compute configuration and `--extra-docker-config` to pass additional Docker configuration as a JSON string. Pass `--update` to pull the latest Docker image before starting, or `--stop` to stop any existing deployment first.

## Options

The `lean private-cloud start` command supports the following options:

| Option | Description |
| --- | --- |
| `--master` | Run in master mode |
| `--slave` | Run in slave mode |
| `--token <string>` | The master server token |
| `--master-domain, --master-ip <string>` | The master server domain |
| `--master-port <integer>` | The master server port |
| `--slave-domain, --slave-ip <string>` | The slave server domain |
| `--update` | Pull the latest image before starting |
| `--no-update` | Do not update to the latest version |
| `--compute <string>` | Compute configuration to use |
| `--extra-docker-config <string>` | Extra docker configuration as a JSON string |
| `--stop` | Stop any existing deployment |
| `--lean-config <file>` | The Lean configuration file that should be used (defaults to the nearest lean.json) |
| `--verbose` | Enable debug logging |
| `--help` | Display the help text of the `lean private-cloud start` command and exit |