Skip to content

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

  1. Enable Zilean in onboarding if your workflow will use it as a search source.
  2. Let DUMB start PostgreSQL and Zilean, then inspect Zilean's startup/import log.
  3. Configure the intended search consumer to use Zilean's internal address and assigned port.
  4. 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_mode determines 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 using clear_on_update
  • env_copy: Paths to copy a .env file 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 145 or 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_update and exclude_dirs settings to preserve persistent data.

AIOStreams integration

AIOStreams can use the local Zilean API as a built-in Debrid search source:

  1. Start Zilean and confirm it is healthy.
  2. In AIOStreams' built-in Zilean settings, enter http://127.0.0.1:8182, replacing 8182 with Zilean's saved DUMB port.
  3. Add the built-in Zilean addon on /stremio/configure.
  4. 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.


Resources