CinePro Documentation

Copy .env.example to .env before starting the server. CinePro Core requires a valid TMDB_API_KEY to resolve metadata and start correctly.

Required vs optional

Required

TMDB_API_KEY — required for metadata lookups and startup

Optional

PORT, HOST, PUBLIC_URL, NODE_ENV — server runtime settings
CACHE_TYPE, REDIS_* — only needed for Redis-backed caching
STREMIO_ADDON, MCP_ENABLED, CORS_ORIGIN, TMDB_CACHE_TTL — optional integrations and tuning

Server configuration

number

default:"3000"

The port CinePro Core listens on.

.env

PORT=3000

.env

PORT=8080

string

default:"localhost"

The hostname or IP address the server binds to.Use localhost during development to keep the API limited to your machine.
Use 0.0.0.0 in Docker or production if the API should be reachable from other devices.

.env

HOST=localhost

.env

HOST=0.0.0.0

string

The public base URL of your CinePro Core instance. Use this when your server is exposed through a public hostname, reverse proxy, or domain.

.env

PUBLIC_URL=https://api.example.com

Include the protocol and do not add a trailing slash. A wrong PUBLIC_URL can produce broken absolute URLs in responses.

string

default:"development"

Controls the runtime mode.

Value	Usage
`development`	Local development, debugging, and `npm run dev`
`production`	Optimized runtime for `npm start` and deployed instances

.env

NODE_ENV=development

.env

NODE_ENV=production

string

Optional. Restricts which browser origins may call the CinePro API.Leave unset to keep the default behavior, or set it to a specific origin if you expose the API publicly.

.env

CORS_ORIGIN=https://example.com

Optional integrations

boolean

default:"false"

Enables CinePro’s Stremio addon support.When enabled, CinePro exposes a Stremio manifest endpoint at /stremio/manifest.json so your instance can be added as a Stremio source.

.env

STREMIO_ADDON=true

Adding custom Stremio addons as sources

CinePro Core can also pull streams from existing Stremio addons and surface them as additional sources. This list is configured in src/server.ts rather than via an environment variable.As of the May 7, 2026 release, the default stremioAddons array is empty — you must explicitly add the addons you want to use:

src/server.ts

stremio: {
    enableNativeAddon: process.env.STREMIO_ADDON === 'true',
    stremioAddons: [
        {
            id: 'some-unique-id',
            url: 'https://example.com/manifest.json',
            enabled: true
        }
    ]
}

Field	Type	Description
`id`	`string`	Unique identifier for the addon within CinePro
`url`	`string`	Full URL to the addon’s `manifest.json`
`enabled`	`boolean`	Toggle the addon without removing the entry

Earlier versions of CinePro Core shipped two community addons (WebStreamerMBG and Streamify) pre-wired in this list. They have been removed so you can curate your own list from a clean slate.

boolean

default:"false"

Returns every source the providers find — including non-playable ones — and attaches detailed per-provider diagnostics to the response. Use this when developing or debugging providers; leave it off in normal use.

.env

INTERNAL_DEBUG=true

Keep INTERNAL_DEBUG=false for regular usage. With it enabled, the API surfaces broken or unplayable sources alongside working ones, which clients are not expected to filter.

boolean

default:"false"

Enables Model Context Protocol support for MCP-compatible clients and AI agents.

.env

MCP_ENABLED=true

Enable this only if you actually plan to connect CinePro to MCP clients. Regular API users do not need it.

TMDB configuration

string

required

Your TMDB (The Movie Database) API key. CinePro Core uses TMDB for metadata such as titles, IDs, and artwork.

Create a TMDB account

Request an API key

Open Settings → API in TMDB and request a developer key.

Add the key to your .env

.env

TMDB_API_KEY=your_tmdb_api_key_here

Keep this key private and never commit your .env file to version control.

number

default:"86400"

Defines how long TMDB metadata responses are cached, in seconds.The default 86400 equals 24 hours.

.env

TMDB_CACHE_TTL=86400

Cache configuration

string

default:"memory"

Selects the cache backend used by CinePro Core.

Value	Best for
`memory`	Local development and simple single-instance setups
`redis`	Production deployments and shared or persistent caching

.env

CACHE_TYPE=memory

.env

CACHE_TYPE=redis

If you use redis, configure the Redis connection variables below as well.

Redis configuration

These variables are only needed when CACHE_TYPE=redis.

string

default:"localhost"

Hostname or IP address of your Redis server.

.env

REDIS_HOST=localhost

.env

REDIS_HOST=redis.example.com

number

default:"6379"

Port of your Redis instance.

.env

REDIS_PORT=6379

string

Optional password for Redis authentication.

.env

REDIS_PASSWORD=

.env

REDIS_PASSWORD=supersecretpassword

Never commit Redis credentials to source control. Use environment injection or a secrets manager in production.

Full .env examples

Development

.env

PORT=3000
HOST=localhost
NODE_ENV=development

TMDB_API_KEY=your_tmdb_api_key_here
TMDB_CACHE_TTL=86400

CACHE_TYPE=memory

Production

.env

PORT=8080
HOST=0.0.0.0
NODE_ENV=production
PUBLIC_URL=https://api.example.com

TMDB_API_KEY=your_tmdb_api_key_here
TMDB_CACHE_TTL=86400

CACHE_TYPE=redis
REDIS_HOST=redis.example.com
REDIS_PORT=6379
REDIS_PASSWORD=supersecretpassword

STREMIO_ADDON=false
MCP_ENABLED=false

Docker Compose

.env

PORT=3000
HOST=0.0.0.0
NODE_ENV=production
PUBLIC_URL=http://localhost:3000

TMDB_API_KEY=your_tmdb_api_key_here
TMDB_CACHE_TTL=86400

CACHE_TYPE=redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=

In Docker Compose, REDIS_HOST should usually be the Redis service name from compose.yml, not localhost.

Get started

General information

Configuration

Ecosystem & versions

Environment variables

Required vs optional

Required

Optional

Server configuration

Optional integrations

Adding custom Stremio addons as sources

TMDB configuration

Cache configuration

Redis configuration

Full .env examples

Development

Production

Docker Compose

​Required vs optional

Required

Optional

​Server configuration

​Optional integrations

​Adding custom Stremio addons as sources

​TMDB configuration

​Cache configuration

​Redis configuration

​Full .env examples

​Development

​Production

​Docker Compose

Required vs optional

Server configuration

Optional integrations

Adding custom Stremio addons as sources

TMDB configuration

Cache configuration

Redis configuration

Full .env examples

Development

Production

Docker Compose