Repository files navigation

Stremio is a free application which lets you stream your favorite shows and movies.

The Docker images in this repository bundle stremio-server, ffmpeg and web player for you, ready to use in a small Alpine image.

I built this to run Stremio on my Raspberry Pi 5 and couldn't find something that has both player and server but also the official image seemed too big but also lacks the Web Player and doesn't work out of the box if no HTTPS is configured.

• All-in-One: Bundles Stremio server, web player, and ffmpeg in a single container.
• Simple Networking: Both the web player and server run on port 8080 behind nginx, so you only need to expose one port.
• Automatic Server Configuration: UseAUTO_SERVER_URL orSERVER_URL to automatically configure the streaming server URL in the web player.
• HTTPS Out-of-the-Box: Automatically generates and uses SSL certificates when anIPADDRESS is provided.
• Custom Certificates: Supports using your own domain and SSL certificates.
• Hardware Acceleration: Includes ffmpeg with VAAPI support for Intel and AMD GPUs.
• Cross-Platform: Builds are available foramd64,arm/v6,arm/v7,arm64/v8, andppc64le.
• HTTP Basic Auth: Secure your instance with a username and password.

• A host with Docker installed.

If you haven't installed Docker yet, you can usually install it with:

curl -sSL https://get.docker.com| shsudo usermod -aG docker$(whoami)exit

And log in again.

Option A: Using Docker Compose (Recommended)

# Clone the repositorygit clone https://github.com/tsaridas/stremio-docker.gitcd stremio-docker# Edit compose.yaml if needed, then run:docker compose up -d

The compose file includes common settings likeNO_CORS: 1 andAUTO_SERVER_URL: 1.

Option B: Using Docker Run

docker run -d \  --name=stremio-docker \  -e NO_CORS=1 \  -e AUTO_SERVER_URL=1 \  -v ./stremio-data:/root/.stremio-server \  -p 8080:8080/tcp \  --restart unless-stopped \  tsaridas/stremio-docker:latest

The Web UI will now be available onhttp://<YOUR_SERVER_IP>:8080. The streaming server will be auto-configured for you from the URL of the browser you are using to open it.

💡 Your configuration files and cache will be saved in./stremio-data on your host machine.

These options can be configured by setting environment variables using-e KEY="VALUE" in thedocker run command.

There are multiple other options defined but probably best not setting any.

Here are some common ways to configure and use this Docker image.

This is the easiest option and works on your local network without needing a public IP or DNS.

• Do not set theIPADDRESS environment variable.
• SetNO_CORS=1 to allow the web player to connect to the server.
• SetAUTO_SERVER_URL=1 to automatically set the server URL.

docker run -d \  --name=stremio-docker \  -e NO_CORS=1 \  -e AUTO_SERVER_URL=1 \  -p 8080:8080 \  tsaridas/stremio-docker:latest

Access Stremio athttp://<YOUR_LAN_IP>:8080.

This option automatically gets a certificate for a*.stremio.rocks subdomain and points it to your public IP address.

• SetIPADDRESS=0.0.0.0 to auto-detect your public IP.
• Expose port8080 and configure port forwarding on your router.

docker run -d \  --name=stremio-docker \  -e IPADDRESS=0.0.0.0 \  -e AUTO_SERVER_URL=1 \  -p 8080:8080 \  tsaridas/stremio-docker:latest

The container will generate a certificate and an A record for your public IP. To find the FQDN, look for a.pem file in your mounted volume (~/.stremio-server).

This is useful for accessing Stremio via HTTPS on your local network. It generates a certificate for a*.stremio.rocks subdomain that resolves to your private IP.

1. SetIPADDRESS to your server's private LAN IP (e.g.,192.168.1.10).

2. The container will generate a certificate for a domain like192-168-1-10.519b6502d940.stremio.rocks. Find the exact FQDN from the.pem filename in your mounted volume.

3. Add an entry to your hosts file on your client machine to point the FQDN to your server's private IP.

   • Linux/macOS:/etc/hosts
   • Windows:c:\Windows\System32\Drivers\etc\hosts

   192.168.1.10    192-168-1-10.519b6502d940.stremio.rocks

4. Run the container:

   docker run -d \  --name=stremio-docker \  -e IPADDRESS=192.168.1.10 \  -e AUTO_SERVER_URL=1 \  -p 8080:8080 \  -v ./stremio-data:/root/.stremio-server \  tsaridas/stremio-docker:latest

5. Access Stremio athttps://192-168-1-10.519b6502d940.stremio.rocks:8080.

If you have your own domain and SSL certificate, you can use them directly.

• Place your certificate file (e.g.,certificate.pem) in the directory you mount to/root/.stremio-server.
• Set theDOMAIN andCERT_FILE environment variables.

docker run -d \  --name=stremio-docker \  -e DOMAIN=your.custom.domain \  -e CERT_FILE=certificate.pem \  -e AUTO_SERVER_URL=1 \  -v ./stremio-data:/root/.stremio-server \  -p 8080:8080 \  tsaridas/stremio-docker:latest

The WebPlayer will be available athttps://your.custom.domain:8080.

To update to the latest version, simply run:

docker stop stremio-dockerdocker rm stremio-dockerdocker pull tsaridas/stremio-docker:latest

And then run yourdocker run ordocker compose up -d command again.

We build our own ffmpeg from the jellyfin repo (version 4.4.1-4), which includes:

• Hardware acceleration support for both Intel and AMD (VAAPI)
• Multiple codec support (H.264, HEVC, VP9, etc.)
• Optimized for streaming workloads

Hardware acceleration is automatically detected. To enable it, you must expose your GPU device to the container.

Support for Intel/AMD GPU Transcoding (VAAPI)

If you have a supported Intel or AMD GPU on Linux, you can enable hardware transcoding by passing thedri device to the container:

Docker Compose:

services:stremio:# ... your other configdevices:      -"/dev/dri:/dev/dri"

Docker CLI:

docker run -d \# ... your other flags  --device /dev/dri:/dev/dri \  tsaridas/stremio-docker:latest

Builds are created for the following architectures:

• linux/amd64
• linux/arm/v6
• linux/arm/v7
• linux/arm64/v8
• linux/ppc64le

Images are automatically built and tested on pull requests using GitHub Actions.

Build tags:

• latest: Builds when a new version of the server or Web Player is released.
• nightly: Builds daily from the development branch of the web player.
• vX.X.X: Specific release versions.

Images are hosted onDocker Hub.

Stremio's web app stores settings in the browser's local storage. You can pre-configure these settings by editing thelocalStorage.json file and mounting it into the container:

docker run -d \# ... your other flags  -v /path/to/your/localStorage.json:/srv/stremio-server/build/localStorage.json \  tsaridas/stremio-docker:latest

The old Stremio shell files are available athttp(s)://<your_url>/shell/. These may have issues with some content like YouTube videos.

• Unable to login through Facebook.

Stremio can be heavy on DNS queries. It's recommended to use a local DNS cache likednsmasq to improve performance.

Therestart_if_idle.sh script can restart the Stremio server when it's not in use. You can add this as a healthcheck in yourcompose.yaml:

healthcheck:test:["CMD-SHELL", "./restart_if_idle.sh"]interval:1hstart_period:1hretries:1

• HTTP Basic Authentication: Supported viaUSERNAME andPASSWORD environment variables.
• HTTPS: Automatic certificate generation is enabled whenIPADDRESS is set.
• CORS: Can be disabled for local deployments withNO_CORS=1.
• Minimal Images: All images are built on Alpine with minimal dependencies.

• Build another image with a base that is small and has glibc.
• Automatically add addons passed from environmental variables.
• Add nginx CORS for security.

PRs and Issues are welcome. If you find an issue, please let me know.