WarpDL can be configured using environment variables. These take precedence over default values.
| Variable |
Description |
Default |
WARPDL_SOCKET_PATH |
Unix socket path for daemon communication |
/tmp/warpdl.sock |
WARPDL_TCP_PORT |
TCP port for daemon (1-65535) |
3849 |
WARPDL_FORCE_TCP |
Force TCP instead of Unix socket (set to “1”) |
false |
WARPDL_PIPE_NAME |
Windows named pipe name |
warpdl |
| Variable |
Description |
Default |
WARPDL_DEBUG |
Enable debug logging (set to “1”) |
false |
WARPDL_SUPPRESS_VERSION_CHECK |
Suppress version check warnings (set to “1”) |
false |
| Variable |
Description |
Default |
WARPDL_PROXY |
Default proxy URL for downloads |
none |
WARPDL_TIMEOUT |
Per-request timeout in seconds |
30 |
WARPDL_MAX_RETRIES |
Maximum retry attempts |
5 |
WARPDL_RETRY_DELAY |
Base retry delay in milliseconds |
500 |
WARPDL_DEFAULT_DL_DIR |
Default download directory |
current directory |
WARPDL_SPEED_LIMIT |
Default speed limit (e.g., 1MB, 512KB) |
unlimited |
WARPDL_SPEED_SCHEDULE |
Daemon throttle window HH:MM-HH:MM:SPEED (e.g., 09:00-17:00:512KB) |
none |
WARPDL_NO_WORK_STEAL |
Disable work stealing (set to “1”) |
false |
WARPDL_INTERFACES |
Interface policy for HTTP downloads: off, auto, or comma-separated device names |
off |
WARPDL_PRIORITY |
Default download priority: high, normal, low |
normal |
WARP_MAX_PARTS |
Maximum file segments (legacy prefix) |
200 |
WARP_MAX_CONN |
Maximum parallel connections (legacy prefix) |
24 |
WARP_FORCE_SEGMENTS |
Force file segmentation (set to “1”, legacy prefix) |
true |
| Variable |
Description |
Default |
WARPDL_DAEMON_URI |
Daemon URI (unix:///path, tcp://host:port, pipe://name) |
auto-detected |
WARPDL_DAEMON_TIMEOUT |
Daemon startup timeout (e.g., 10s, 1m) |
10s |
WARPDL_MAX_CONCURRENT |
Maximum concurrent downloads (0 = unlimited) |
3 |
| Variable |
Description |
Default |
WARPDL_CONFIG_DIR |
Configuration directory path |
~/.config/warpdl |
WARPDL_COOKIE_KEY |
Credential encryption key (hex format) |
auto-generated |
| Variable |
Description |
Default |
WARP_NO_BROWSER |
Disable automatic browser opening (set to “1”) |
false |
Note: WARP_NO_BROWSER uses the WARP_ prefix (without “DL”) for historical compatibility. WARPDL_NO_BROWSER is not recognized.
WARPDL_SOCKET_PATH is used for IPC by default- Set
WARPDL_FORCE_TCP=1 to use TCP instead
WARPDL_PIPE_NAME is used for named pipe IPC- Falls back to TCP if named pipes fail
WARPDL_RPC_LISTEN_ALL - Listen on all interfaces in service mode (set to “1” or “true”); the JSON-RPC endpoint is unauthenticated, so restrict this to a reverse proxy or firewall
