Direct Downloads
Configure GetComics, DDL, FlareSolverr, proxy, and external server settings.
Direct downloads (DDL) let Comicarr grab comics from HTTP file hosts without a separate download client. Supported hosts include Mega, MediaFire, Pixeldrain, and GetComics.
Enabling Direct Downloads
| Setting | Type | Default | Description |
|---|---|---|---|
ENABLE_GETCOMICS | bool | False | Enable searching GetComics as a source. |
ENABLE_DDL | bool | False | Enable the direct download pipeline. |
ENABLE_GETCOMICS controls the search provider. ENABLE_DDL controls the download mechanism. You typically enable both together.
DDL Settings
| Setting | Type | Default | Description |
|---|---|---|---|
DDL_LOCATION | string | — | Directory where DDL files are saved before post-processing. |
DDL_AUTORESUME | bool | True | Automatically resume interrupted downloads. |
DDL_PREFER_UPSCALED | bool | True | Prefer upscaled/higher-quality releases when multiple links are available. |
DDL_PRIORITY_ORDER | string | — | Comma-separated host priority (e.g. pixeldrain,mega,mediafire). |
DDL_STUCK_NOTIFY | bool | True | Send a notification when a download appears stuck. |
DDL_STUCK_THRESHOLD | int | 30 | Minutes of no progress before a download is considered stuck. |
DDL_STUCK_CHECK_INTERVAL | int | 10 | Minutes between stuck-download checks. |
FlareSolverr
Some sites use Cloudflare protection. FlareSolverr acts as a proxy that solves Cloudflare challenges on Comicarr's behalf.
| Setting | Type | Default | Description |
|---|---|---|---|
ENABLE_FLARESOLVERR | bool | False | Route DDL requests through FlareSolverr. |
FLARESOLVERR_URL | string | — | FlareSolverr URL (e.g. http://localhost:8191). |
Deploy FlareSolverr
Add FlareSolverr to your Docker Compose stack:
flaresolverr:
image: ghcr.io/flaresolverr/flaresolverr:latest
container_name: flaresolverr
ports:
- 8191:8191
restart: unless-stoppedEnable in Comicarr
Set ENABLE_FLARESOLVERR to True and enter the FlareSolverr URL (e.g. http://flaresolverr:8191 if on the same Docker network).
Proxy
Route all DDL traffic through an HTTP or HTTPS proxy.
| Setting | Type | Default | Description |
|---|---|---|---|
ENABLE_PROXY | bool | False | Enable proxy for direct download requests. |
HTTP_PROXY | string | — | HTTP proxy URL (e.g. http://proxy:3128). |
HTTPS_PROXY | string | — | HTTPS proxy URL (e.g. http://proxy:3128). |
External Server
Delegate downloads to a remote Comicarr instance or compatible server.
| Setting | Type | Default | Description |
|---|---|---|---|
ENABLE_EXTERNAL_SERVER | bool | False | Send download requests to an external server. |
EXTERNAL_SERVER | string | — | Base URL of the external server. |
EXTERNAL_USERNAME | string | — | Username for external server authentication. |
EXTERNAL_APIKEY | string | — | API key for external server authentication. Encrypted at rest. |
Supported Hosts
| Host | Notes |
|---|---|
| Mega | Requires no account for public links. Large files may need a Mega account. |
| MediaFire | Public file links are supported. |
| Pixeldrain | Fast, no-account downloads. Often the fastest option. |
| GetComics | Acts as both a search provider and a link aggregator for the above hosts. |
Mega has bandwidth limits for free accounts. If downloads stall, consider configuring DDL_PRIORITY_ORDER to prefer Pixeldrain or MediaFire.