# General

## `disable_crawlers`

| Type                | Default | Additional Info                                                                                                 |
| ------------------- | ------- | --------------------------------------------------------------------------------------------------------------- |
| `list[NonEmptyStr]` | `[]`    | This is an [`AdditiveArg`](/cyberdrop-dl/reference/configuration-options/special_setting_types.md#additiveargs) |

You can supply a list of crawlers to disable for the current run. This will make CDL completely ignore the crawler, as if the site was not supported. However, links from the site will still be processed by Real-Debrid (if enabled), Jdownloader (If enabled) and the Generic crawler (If enabled), in that order.

The list should be valid crawlers names. The name of the crawler is the name of the primary site they support. ex: `4Chan`, `Bunkrr`, `Dropbox`

Crawlers names correspond to the column `site` in the [supported sites page](https://script-ware.gitbook.io/cyberdrop-dl/reference/supported-websites#supported-sites).

## `enable_generic_crawler`

| Type   | Default |
| ------ | ------- |
| `bool` | `false` |

CDL has a generic crawler that will try to download from unsupported sites. Setting this to `true` will enable it.

{% hint style="info" %}
CDL will always try to download from unsupported URLs if the last part of the URL has a known file extension. ex: `.jpg`
{% endhint %}

## `flaresolverr`

| Type                | Default |
| ------------------- | ------- |
| `HttpURL` or `null` | `null`  |

[FlareSolverr](https://github.com/FlareSolverr/FlareSolverr) is a proxy server to bypass Cloudflare and `DDoS-Guard` protection. The provided value must be a valid `http` URL of an existing flaresolverr instance. Ex: `http://192.168.1.44:4000`

{% hint style="info" %}
`0.0.0.0` is NOT a valid IP address. To set up a flaresolverr instance running on the same machine as CDL, use `127.0.0.1` as the IP
{% endhint %}

{% hint style="warning" %}
This wiki does not cover flaresolverr setup process. If you need help, refer to their documentation. Please do not open issues related to flaresolverr or `DDoS-Guard`. See: [How to extract cookies (DDoSGuard or login errors) #839](https://github.com/Cyberdrop-DL/cyberdrop-dl/discussions/839) for alternatives using cookies
{% endhint %}

## `max_file_name_length`

| Type          | Default |
| ------------- | ------- |
| `PositiveInt` | `95`    |

This is the maximum number of characters a filename should have. CDL will truncate filenames longer that this.

## `max_folder_name_length`

| Type          | Default |
| ------------- | ------- |
| `PositiveInt` | `95`    |

This is the maximum number of characters a folder should have. CDL will truncate folders longer that this.

## `proxy`

| Type                | Default |
| ------------------- | ------- |
| `HttpURL` or `null` | `null`  |

The proxy you want CDL to use. Only `http` proxies are supported. Ex: `https://user:password@ip:port`

## `required_free_space`

| Type       | Default | Restrictions |
| ---------- | ------- | ------------ |
| `ByteSize` | `5GB`   | `>=512MB`    |

This is the minimum amount of free space require to start new downloads.

{% hint style="info" %}
If you set a value lower than `512MB`, CDL will override it with `512MB`
{% endhint %}

## `ssl_context`

| Type                  | Default              |
| --------------------- | -------------------- |
| `NonEmptyStr` or None | `truststore+certifi` |

Context that will used to verify SSL connections. Valid values are:

* `truststore`: Will use certificates already included with the OS
* `certifi`: Will use certificates bundled with the `certifi` version available at the release of the current CDL version
* `truststore+certifi`: Will use certificates already included with the OS, with a fallback to `certifi` for missing certificates
* `None`: Will completely disable SSL verification, allowing insecure connections.

Setting this to `None` will allow the program to connect to websites without SSL encryption (insecurely).

{% hint style="danger" %}
Sensitive data may be exposed using an insecure connection. For your safety, is recommended to always use a secure HTTPS connection.
{% endhint %}

## `user_agent`

| Type          | Default                                                                  |
| ------------- | ------------------------------------------------------------------------ |
| `NonEmptyStr` | `Mozilla/5.0 (X11; Linux x86_64; rv:150.0) Gecko/20100101 Firefox/150.0` |

The user agent is the signature of your browser. Some sites use it to identify if the requests come from a human or a robot. You can google "what is my user agent" to get yours.

{% hint style="info" %}
If you use flaresolverr, this value MUST match with flaresolverr's user agent. Otherwise, flaresolverr cookies won't work
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://script-ware.gitbook.io/cyberdrop-dl/reference/configuration-options/global-settings/general.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.