Skip to content

Advanced Configuration of StreamFusion

This section details all the environment variables that can be configured to customize StreamFusion's behavior. These variables can be passed either as Docker secrets or as container environment variables (in uppercase).

Caution regarding automatic configuration

Some environment variables are automatically configured when the application starts, based on your installation. Manually overriding these variables can lead to undesired behavior of StreamFusion, particularly regarding interactions with debridging services.

The concerned variables include:

  • PROXIED_LINK
  • RD_UNIQUE_ACCOUNT
  • AD_UNIQUE_ACCOUNT
  • AD_USE_PROXY
  • JACKETT_ENABLE
  • YGG_UNIQUE_ACCOUNT
  • SHAREWOOD_UNIQUE_ACCOUNT

Before manually modifying these variables, make sure you understand their impact on the application's functioning. Incorrect configuration could compromise the stability and security of your StreamFusion installation.

General Variables

Variable Description Default Value
SESSION_KEY Session key for the application Automatically generated
USE_HTTPS Enable HTTPS false
DEFAULT_DEBRID_SERVICE Default debridging service RD (RealDebrid)

Session Key

The SESSION_KEY is automatically generated when the container starts, ensuring a unique key for each StreamFusion installation. This practice enhances the security of your application.

  • It is strongly advised against manually setting this value via an environment variable.
  • The automatic rotation of this key will not affect existing user connections.
  • This approach follows best practices for web application security.

Server Configuration

Variable Description Default Value
WORKERS_COUNT Number of workers for the application Automatically calculated
PORT Port on which the application listens 8080
HOST Host on which the application listens 0.0.0.0
GUNICORN_TIMEOUT Timeout for Gunicorn (in seconds) 180
AIOHTTP_TIMEOUT Timeout for aiohttp (in seconds) 7200

Proxy Configuration

Variable Description Default Value
PROXIED_LINK Enable link proxification Depends on configuration
PROXY_URL URL of the proxy to use None
PLAYBACK_PROXY Use proxy for stream links from the server None

Functioning of proxy variables

  • PROXIED_LINK: Transforms the application into a proxy, passing all streams through the server. Used to share a debridger account among all users.
  • PROXY_URL: Contains the URL of the user's proxy.
  • PLAYBACK_PROXY: Applies the proxy to all StreamFusion interactions with debridgers, including streaming links. Useful when PROXIED_LINK is enabled, so that video streaming also passes through the configured proxy.

Use of proxies and interactions with debridgers

It's important to understand the different aspects of interactions with debridgers:

  1. Streaming: Concerns the streaming links of debrided content.
  2. API Interactions: Concerns requests to the debridgers' API.
  • Some debridgers (like AllDebrid) block API requests coming from servers, hence the use of a proxy to contact them.
  • It may happen that server IP addresses are banned by RealDebrid or AllDebrid, preventing even the streaming of video links. In this case, activate PLAYBACK_PROXY to pass video playback through the proxy.
  • The use of PLAYBACK_PROXY is generally avoided to save resources and reduce latency, except when necessary.

RealDebrid Configuration

Variable Description Default Value
RD_TOKEN RealDebrid authentication token None
RD_UNIQUE_ACCOUNT Use a unique RealDebrid account Depends on configuration

AllDebrid Configuration

Variable Description Default Value
AD_TOKEN AllDebrid authentication token None
AD_UNIQUE_ACCOUNT Use a unique AllDebrid account Depends on configuration
AD_USER_APP Application name for AllDebrid streamfusion
AD_USER_IP User IP for AllDebrid None
AD_USE_PROXY Use a proxy for AllDebrid Depends on configuration

Logging Configuration

Variable Description Default Value
LOG_LEVEL Log level INFO
LOG_PATH Path to the log file /app/config/logs/stream-fusion.log
LOG_REDACTED Hide sensitive information in logs true

Security Configuration

Variable Description Default Value
SECRET_API_KEY Secret API key None
SECURITY_HIDE_DOCS Hide API documentation true

PostgreSQL Configuration

Variable Description Default Value
PG_HOST PostgreSQL host stremio-postgres
PG_PORT PostgreSQL port 5432
PG_USER PostgreSQL user streamfusion
PG_PASS PostgreSQL password streamfusion
PG_BASE PostgreSQL database name streamfusion
PG_ECHO Enable SQL echo false

Redis Configuration

Variable Description Default Value
REDIS_HOST Redis host redis
REDIS_PORT Redis port 6379
REDIS_DB Redis database number 5
REDIS_EXPIRATION Redis key expiration duration (in seconds) 604800
REDIS_PASSWORD Redis password None

TMDB Configuration

Variable Description Default Value
TMDB_API_KEY TMDB API key None

Jackett Configuration

Variable Description Default Value
JACKETT_HOST Jackett host jackett
JACKETT_SCHEMA Jackett URL schema http
JACKETT_PORT Jackett port 9117
JACKETT_API_KEY Jackett API key None
JACKETT_ENABLE Enable Jackett integration Depends on configuration

Zilean DMM API Configuration

Variable Description Default Value
ZILEAN_HOST Zilean host zilean
ZILEAN_PORT Zilean port 8181
ZILEAN_SCHEMA Zilean URL schema http
ZILEAN_MAX_WORKERS Maximum number of Zilean workers 4
ZILEAN_POOL_CONNECTIONS Zilean connection pool size 10
ZILEAN_API_POOL_MAXSIZE Zilean API pool maximum size 10
ZILEAN_MAX_RETRY Maximum number of Zilean retries 3

YGGFlix Configuration

Variable Description Default Value
YGGFLIX_URL YGGFlix URL https://yggflix.fr
YGGFLIX_MAX_WORKERS Maximum number of YGGFlix workers 4
YGG_PASSKEY YGG passkey None
YGG_UNIQUE_ACCOUNT Use a unique YGG account Depends on configuration

Sharewood Configuration

Variable Description Default Value
SHAREWOOD_URL Sharewood URL https://www.sharewood.tv
SHAREWOOD_MAX_WORKERS Maximum number of Sharewood workers 4
SHAREWOOD_PASSKEY Sharewood passkey None
SHAREWOOD_UNIQUE_ACCOUNT Use a unique Sharewood account Depends on configuration

Public Cache Configuration

Variable Description Default Value
PUBLIC_CACHE_URL Public cache URL https://stremio-jackett-cacher.elfhosted.com/

Development Configuration

Variable Description Default Value
DEBUG Enable debug mode false
DEV_HOST Development host 0.0.0.0
DEV_PORT Development port 8080
DEVELOP Enable development mode false
RELOAD Enable automatic reloading false

Security

Make sure not to expose sensitive information such as tokens and API keys in unsecured environments.