Skip to main content
This guide walks you through cloning the repository and starting the development server.

​
Prerequisites

Before you begin, make sure you have the following installed:
ToolRequired versionNotes
Node.js20.xSee .nvmrc — use nvm use to switch automatically
pnpm10 or higherInstallation guide
If you use nvm, run nvm use in the project root to switch to Node 20 automatically.

​
Get running locally

1

Clone the repository

git clone https://github.com/Stremio/stremio-web.git
cd stremio-web
2

Install dependencies

pnpm install
pnpm resolves dependencies from pnpm-lock.yaml. This typically takes 30–60 seconds on first run.
3

Start the development server

pnpm start
This runs webpack serve --mode development and starts an HTTPS dev server on all interfaces (0.0.0.0).
The dev server uses HTTPS by default. Your browser will show a certificate warning for localhost — this is expected. Accept the warning to proceed.
4

Open the app in your browser

Navigate to:
https://localhost:8080
You should see the Stremio Web interface load. If it prompts you to connect to a Stremio Core service, that means the frontend is working correctly.

​
What to expect

After the dev server starts, you’ll have:
  • Hot-module-free live builds — Webpack rebuilds on file changes (live reload is disabled; refresh the page manually).
  • Source maps — eval-source-map is enabled in development for easier debugging.
  • Debug mode — The DEBUG environment variable is set to true, which enables additional logging.
Stremio Web connects to Stremio Core to load catalogs and streams. Without a running Core instance the UI will open but content will not load.

​
Next steps

Installation options

Production builds, Docker, and advanced setup

Contributing

Learn how to contribute to the codebase

Build docs developers (and LLMs) love

Get started for freeTalk to us