Zilean¶
Zilean indexes shared Debrid Media Manager hash lists and exposes search and Torznab interfaces. It can also ingest supported Zurg and Zilean sources. DUMB manages its runtime and PostgreSQL database; configure consumers such as CLI Debrid, Riven, or AIOStreams to use its search endpoint.
At a glance¶
Zilean provides search data to other applications. Check a search from the consumer before relying on automated acquisition.
flowchart TD
A["Start PostgreSQL and Zilean"] --> B
B["Review the startup and import log"] --> C
C["Configure the intended search consumer"] --> D
D["Test a search from that consumer"] --> E
E["Review its returned results"]
First start¶
- Enable Zilean in onboarding if your workflow will use it as a search source.
- Let DUMB start PostgreSQL and Zilean, then inspect Zilean's startup/import log.
- Configure the intended search consumer to use Zilean's internal address and assigned port.
- Test a search from that consumer before relying on automated acquisition.
Technical details: configuration reference
Configuration Settings in dumb_config.json¶
Merge overrides into the zilean section of your existing configuration:
{
"zilean": {
"enabled": false,
"process_name": "Zilean",
"repo_owner": "iPromKnight",
"repo_name": "zilean",
"release_version_enabled": false,
"release_version": "v3.3.0",
"commit_sha": "",
"branch_enabled": false,
"branch": "main",
"suppress_logging": false,
"log_level": "INFO",
"host": "127.0.0.1",
"port": 8182,
"auto_update": false,
"auto_update_interval": 24,
"auto_update_start_time": "04:00",
"clear_on_update": true,
"exclude_dirs": ["/zilean/app/data"],
"env_copy": {
"source": "/zilean/app/data/.env",
"destination": "/zilean/app/src/.env"
},
"platforms": ["python", "dotnet"],
"command": ["/zilean/app/zilean-api"],
"config_dir": "/zilean",
"config_file": "/zilean/app/data/settings.json",
"log_file": "/log/zilean.log",
"env": {
"DOTNET_RUNNING_IN_CONTAINER": "true",
"DOTNET_gcServer": "1",
"DOTNET_GCDynamicAdaptationMode": "1",
"DOTNET_SYSTEM_GLOBALIZATION_INVARIANT": "false",
"PYTHONUNBUFFERED": "1",
"ASPNETCORE_URLS": "http://+:{port}",
"PYTHONPATH": "/zilean/venv/lib/python3.11/site-packages",
"PATH": "/zilean/venv/bin:${PATH}",
"ZILEAN_PYTHON_PYLIB": "/usr/local/lib/libpython3.11.so.1.0",
"Zilean__Database__ConnectionString": "Host={postgres_host};Port={postgres_port};Database=zilean;Username={postgres_user};Password={postgres_password};Timeout=300;CommandTimeout=3600;"
}
}
}
Configuration Key Descriptions¶
enabled: Whether to start the Zilean service.process_name: Used in logs and process tracking.repo_owner/repo_name: GitHub repo to pull from.release_version_enabled/release_version: Use a tagged release if enabled.commit_sha: Builds an exact Zilean revision from its full 40-character GitHub SHA.branch_enabled/branch: Use a specific branch if enabled.suppress_logging: Suppresses service messages in the main DUMB output.log_level: Logging verbosity (e.g.,DEBUG,INFO).host: IP address for the Zilean service to bind to.port: Port the Zilean API is exposed on.auto_update: Enables DUMB's scheduled update checks;auto_update_modedetermines whether a detected update is installed.auto_update_interval: How often (in hours) to check for updates.clear_on_update: Clears build artifacts or cache during updates.exclude_dirs: Prevents specific directories from being affected by updates when usingclear_on_updateenv_copy: Paths to copy a.envfile from source to destination for runtime support.platforms: Required environments—Zilean uses both .NET and Python.command: The binary or command used to launch Zilean.config_dir/config_file: Where configuration files are stored and loaded.log_file: Path to the Zilean log file.env: Dictionary of environment variables passed at runtime, including:DOTNET_RUNNING_IN_CONTAINER: Informs .NET that it is containerized.DOTNET_gcServer: Enables server-mode garbage collection.DOTNET_GCDynamicAdaptationMode: Adjusts GC behavior adaptively.DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: Controls globalization features.PYTHONUNBUFFERED: Ensures Python output is unbuffered.ASPNETCORE_URLS: Specifies ASP.NET Core server bind address.PYTHONPATH: Adds Python libraries to runtime path.PATH: Prepends Python virtual environment binaries.ZILEAN_PYTHON_PYLIB: Full path to the Python shared object.Zilean__Database__ConnectionString: Connection string for PostgreSQL.
Commit / Branch / Version Targeting¶
Choose a full commit_sha, a release selector, or an enabled branch in this service's DUMB settings. A commit pin takes precedence over the other selectors and disables automatic updates until you clear it. Review source selection and update modes before changing a running service.
Tips¶
- The first-time run of Zilean can take a long time; see the Zilean FAQ for more info.
- Runtime Zilean rebuilds use an on-demand managed .NET 10 SDK. See the Zilean SDK troubleshooting guide if restore reports exit code
145or no installed SDK. - Logs from Zilean can be accessed via DUMB’s Frontend or directly from
/log/zilean.log. - If Zilean fails to bind, check for existing services on port
8182. - Use the
clear_on_updateandexclude_dirssettings to preserve persistent data.
AIOStreams integration¶
AIOStreams can use the local Zilean API as a built-in Debrid search source:
- Start Zilean and confirm it is healthy.
- In AIOStreams' built-in Zilean settings, enter
http://127.0.0.1:8182, replacing8182with Zilean's saved DUMB port. - Add the built-in Zilean addon on
/stremio/configure. - Select a compatible Debrid playback service for its results.
Zilean supplies cached Debrid Media Manager hash-list results. It is not a Usenet playback service and does not route results through InfiniDysk or AltMount.