This article is focused on setting up a development environment to create and contribute supported new content. If you are not planning to contribute or your contribution will be only community supported, the content in this article is not required. For more details, refer to the Getting Started Guide.
For details, the Setup Tutorial summarizes the end-to-end steps that are required.
Fork the Cortex XSOAR Content repository and create a branch for your contribution. Do not work on the
Follow this guide to set up a fully configured remote development environment.
Follow this guide to set up a fully configured local environment.
You will need
python3 installed on your system. We recommend using
pyenv. At the time of this writing, the latest version of Python 3.10 is 3.10.5.
pyenv is installed first and that the
eval "$(pyenv init -)" expression is placed in your shell configuration (
~/.zshrc). For additional information see this guide.
pyenv, you can install
Demisto-sdk uses Docker to run certain commands. Follow the instructions in the Docker Getting Started guide to install Docker in your host.
Note: If you are using Windows with WSL2, you can still use Docker Desktop from WSL. Follow the instructions in this tutorial for details.
To install the
nvm package manager, follow the instructions in this nvm guide.
After installing, run:
Pipx is a package that enables you to install and run the Python application globally in an isolated Python environment.
This is our help tool that will ease the contribution process. It will help you to generate a Pack, maintain your files, and validate them before committing to the branch.
To install demisto-sdk using
To check the you have the latest version of the SDK, run:
bootstrap script. The script will set up a pre-commit hook that will validate your modified files before committing. It will also set up a python virtual environment for development with the package requirements for Python3. Run the script from the root directory of the source tree:
After the script completes, you can activate the newly created virtual environment by running:
Congratulations! You now have a fully configured virtual environment, where you can run our different validation and utility scripts.
For more details, refer to the end-to-end Tutorial.
Cortex XSOAR offers two IDEs for developing:
- Built-in Platform Cortex XSOAR IDE (not recommended for complex/advanced use cases. More details here.)
- Visual Studio Code Extension
You can also use your IDE of choice along with
demisto-sdk, for example, Visual Studio Code.