Introduction - tsaridas/stremio-docker GitHub Wiki

Easy stremio on Docker

Introduction

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.

Features

  • 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: Use AUTO_SERVER_URL or SERVER_URL to automatically configure the streaming server URL in the web player.
  • HTTPS Out-of-the-Box: Automatically generates and uses SSL certificates when an IPADDRESS 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 for amd64, arm/v6, arm/v7, arm64/v8, and ppc64le.
  • HTTP Basic Auth: Secure your instance with a username and password.

Requirements

  • A host with Docker installed.

Installation

1. Install Docker

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

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

And log in again.

2. Run Stremio

Option A: Using Docker Compose (Recommended)

# Clone the repository
git clone https://github.com/tsaridas/stremio-docker.git
cd stremio-docker

# Edit compose.yaml if needed, then run:
docker compose up -d

The compose file includes common settings like NO_CORS: 1 and AUTO_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 on http://<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.

Usage & Configuration Scenarios

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

Additional Documentation