---
title: rattler-build debug setup
---
<!--- This file is autogenerated. Do not edit manually! -->
# [rattler-build](../index.md) [debug](index.md) setup

Set up a debug environment from a recipe

## Usage
```
rattler-build debug setup [OPTIONS]
```

## Options
- <a id="arg---recipe" href="#arg---recipe">`--recipe (-r) <RECIPE>`</a>
:  Recipe file or directory to debug
<br>**default**: `.`
- <a id="arg---target-platform" href="#arg---target-platform">`--target-platform <TARGET_PLATFORM>`</a>
:  The target platform to build for
- <a id="arg---host-platform" href="#arg---host-platform">`--host-platform <HOST_PLATFORM>`</a>
:  The host platform to build for (defaults to target_platform)
- <a id="arg---build-platform" href="#arg---build-platform">`--build-platform <BUILD_PLATFORM>`</a>
:  The build platform to build for (defaults to current platform)
- <a id="arg---channel" href="#arg---channel">`--channel (-c) <CHANNELS>`</a>
:  Channels to use when building
<br>May be provided more than once.
- <a id="arg---output-name" href="#arg---output-name">`--output-name <OUTPUT_NAME>`</a>
:  Name of the specific output to debug (only required when a recipe has multiple outputs)
- <a id="arg---variant-config" href="#arg---variant-config">`--variant-config (-m) <VARIANT_CONFIG>`</a>
:  Variant configuration files for the build
<br>May be provided more than once.
- <a id="arg---variant" href="#arg---variant">`--variant <VARIANT_OVERRIDES>`</a>
:  Override specific variant values (e.g. --variant python=3.12 or --variant python=3.12,3.11). Multiple values separated by commas will create multiple build variants
<br>May be provided more than once.
- <a id="arg---ignore-recipe-variants" href="#arg---ignore-recipe-variants">`--ignore-recipe-variants`</a>
:  Do not read the `variants.yaml` file next to a recipe
- <a id="arg---experimental" href="#arg---experimental">`--experimental`</a>
:  Enable experimental features
<br>**env**: `RATTLER_BUILD_EXPERIMENTAL`
- <a id="arg---v3" href="#arg---v3">`--v3`</a>
:  Enable V3 recipe fields and MatchSpec syntax
- <a id="arg---allow-insecure-host" href="#arg---allow-insecure-host">`--allow-insecure-host <ALLOW_INSECURE_HOST>`</a>
:  List of hosts for which SSL certificate verification should be skipped
<br>May be provided more than once.
- <a id="arg---channel-priority" href="#arg---channel-priority">`--channel-priority <CHANNEL_PRIORITY>`</a>
:  Channel priority to use when solving

## Modifying result
- <a id="arg---output-dir" href="#arg---output-dir">`--output-dir <OUTPUT_DIR>`</a>
:  Output directory for build artifacts.
<br>**env**: `CONDA_BLD_PATH`

## Description
Set up a debug environment from a recipe.

Resolves dependencies, downloads sources, applies patches, installs build/host environments, and creates the build script — then stops. Use `debug shell` or `debug run` afterwards to work in the environment.

