User Guides

Troubleshooting

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.

Common errors

The following errors are commonly seen when using the CLI:

Error messagePossible 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.
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 already, or visit Installing Docker if you haven't.
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 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 a directory you have previously ran lean init in (which generates the lean.json file), or by specifying the path to the lean.json file with the --lean-config option.
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 the directory in which you ran lean init 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 Preferences->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 the directory you ran lean init in. To do so, open your Docker settings, go to Resources > File sharing and add C:/Users/<username>/AppData/Local/Temp and the directory you ran lean init in to the list. Click Apply & Restart after making the required changes.

Reporting an issue

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 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.

You can also see our Videos. You can also get in touch with us via Chat.

Did you find this page helpful?

Contribute to the documentation: