---
title: "Troubleshooting"
description: "This page lists common errors with their possible cause and a way to fix them."
canonical: https://www.quantconnect.com/docs/v2/lean-cli/key-concepts/troubleshooting
markdown: https://www.quantconnect.com/docs/v2/lean-cli/key-concepts/troubleshooting.md
language: python
source: https://github.com/QuantConnect/Documentation/tree/master/05%20Lean%20CLI/01%20Key%20Concepts/02%20Troubleshooting
modified: 2026-10-30
index: https://www.quantconnect.com/llms.txt
---

# Troubleshooting

[Documentation](https://www.quantconnect.com/docs/v2.md) > [Lean CLI](https://www.quantconnect.com/docs/v2/lean-cli.md) > Key Concepts > Troubleshooting

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

## Introduction

You might occassionally receive an error indicating that something went wrong. We try to provide accurate error descriptions in the CLI, but in some cases, those might not be enough. This page lists common errors with their possible cause and a way to fix them. In case you still need help after that this page also contains instructions on how to report issues to our engineers in a way that makes it easy for us to help you with your issue.

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.

## Common Errors

The following table describes errors you may see when using the CLI:

| Error Message | Possible Cause and Fix |
| --- | --- |
| No such command '<name>' No such option: <option> | The command you tried to run does not exist or it doesn't support the option you provided. If the documentation says it is available you are probably using an outdated version of the CLI. Run `pip install --upgrade lean` to update to the latest version. |
| No such file | Follow these steps: Open the advance settings in Docker Desktop. Disable the **Allow the default Docker socket to be used** setting. Save and restart the Docker container. Enable the **Allow the default Docker socket to be used** setting. Save and restart the Docker container. |
| Invalid credentials, please log in using `lean login` | You are trying to use a command which communicates with the QuantConnect API and you haven't authenticated yourself yet. Run `lean login` to log in with your API credentials. |
| Please make sure Docker is installed and running | You are trying to use a command which needs to run the LEAN engine locally, which always happens in a Docker container. Make sure Docker is running if you [installed it](https://www.quantconnect.com/docs/v2/lean-cli/installation/installing-lean-cli.md#02-Install-Docker) already. If Docker is already running, run your command with `--verbose` for more information. |
| Please make sure Docker is installed and running | Your venv probably has a non standard docker path or no docker access. Uninstall and [reinstall](https://www.quantconnect.com/docs/v2/lean-cli/installation/installing-lean-cli.md#02-Install-Docker) docker. |
| This command requires a Lean configuration file, run `lean init` in an empty directory to create one, or specify the file to use with --lean-config | The command you are trying to run requires a [Lean configuration](https://www.quantconnect.com/docs/v2/lean-cli/initialization/configuration.md#03-Lean-Configuration) file. The CLI automatically tries to find this file by recursively looking in the current directory and all of the parent directories for a `lean.json` file. This error is shown if no such file can be found. It can be fixed by running the command in your [organization workspace directory](https://www.quantconnect.com/docs/v2/lean-cli/initialization/organization-workspaces.md) (which generates the `lean.json` file), or by specifying the path to the `lean.json` file with the `--lean-config` option. |
| We couldn't find you account in the given organization, ORG: <32-char-hash> | The organization Id found in the `lean.json` is incorrect. You need to [re-install](https://www.quantconnect.com/docs/v2/lean-cli/initialization/configuration.md) Lean CLI running `lean init` in an empty directory. |
| Invalid value for 'PROJECT': Path '<path>' does not exist. | You are trying to run an action on a project but specified an invalid project path. Make sure you are running the command from your [organization workspace directory](https://www.quantconnect.com/docs/v2/lean-cli/initialization/organization-workspaces.md) and make sure `./<path>` points to an existing directory. |
| '<path>' is not a valid path | You provided a path that is not valid for your operating system. This error is most likely to appear on Windows, where the following characters are not allowed in path components: `<`, `>`, `:`, `"`, `\|`, `?`, and `*`. On top of those characters the following names are not allowed (case-insensitive): `CON`, `PRN`, `AUX`, `NUL`, `COM1` until `COM9`, and `LPT1` until `LPT9`. Last but not least, path components cannot start or end with a space or end with a period on Windows. |
| invalid mount config for type "bind": bind source path does not exist: `/ var / folders / <path> / config.json` Mounts denied: The path `/ Users / <path> / data` is not shared from the host and is not known to Docker | Your Mac's Docker file sharing settings do not permit binding one or more directories that we need to share with the container. Go to Docker's **Settings > Resources > File Sharing** and add `/ private / var / folders` and either `/ Users` to share your entire `/ Users` directory, or `/ Users / <path>` where `<path>` is the path to your QuantConnect directory, which should have a `data` child directory, and child directories for your individual projects. |
| Docker wants access to <path> | You are running Docker on Windows using the legacy Hyper-V backend and haven't configured file sharing correctly. You need to enable file sharing for your temporary directories and for your [organization workspace directory](https://www.quantconnect.com/docs/v2/lean-cli/initialization/organization-workspaces.md). To do so, open your Docker settings, go to **Resources > File Sharing** and add `C: / Users / <username> / AppData / Local / Temp` and your organization workspace directory to the list. Click **Apply & Restart** after making the required changes. |
| Could not open '/lib64/ld-linux-x86-64.so.2': No such file or directory | Your Docker installation has pulled the incorrect platform version of the LEAN Docker image. Open your terminal. Run `docker rmi quantconnect/lean` to remove the `quantconnect/lean` image and then run `docker pull quantconnect/lean --platform=linux/amd64`. |
| Could not find file '/root/ibgateway/ibgateway'. | Your Docker installation has pulled the ARM platform version of the LEAN Docker image. This version doesn't include IB Gateway, because QuantConnect doesn't support [Interactive Brokers](https://qnt.co/interactive-brokers) integration with ARM chips (e.g.: Apple M1, M2, and M3 chips). |

## Report Issues

If with the information on this page and the error message shown by the CLI you're still unable to solve your issues you are welcome to contact our engineers by opening an issue in the [QuantConnect/lean-cli repository](https://github.com/QuantConnect/lean-cli) on GitHub. Before doing so, please run the command that's giving issues with the `--verbose` flag and copy and paste the output into the issue (feel free to mask sensitive information). The `--verbose` flag enables debug messages to be printed, which makes it easier for us to help you.