Run https://iptvnator.vercel.app self-hosted

[abkoch]

Hello,

may i run https://iptvnator.vercel.app self-hosted and if possible, how?

And/Or is there an option to run IPTVNator without node.js etc. with JavaScript, HTML5 and CSS only?

Best regards
Andreas

[4gray]

Hi Andreas,

Self-hosting — yes, that's supported. The same web app that runs on iptvnator.vercel.app is available as a single Docker image that bundles everything it needs: the PWA served by nginx plus a small API backend under /api (the old separate iptvnator-backend container is no longer needed).

docker run -d --name iptvnator -p 4333:80 4gray/iptvnator:latest

Then open http://localhost:4333. Or with compose / building from source:

git clone https://github.com/4gray/iptvnator.git
cd iptvnator
docker compose -f docker/docker-compose.yml up --build -d

See docker/README.md for environment variables (e.g. set CLIENT_URL to your public URL when running behind a reverse proxy), available image tags, and the limitations of the PWA compared to the desktop app.

Running with plain JS/HTML/CSS only — partially. The frontend compiles to static files (pnpm nx build web --configuration=pwa → dist/apps/web), so you can serve it from any static web server — nginx, Apache, Caddy — with no Node.js at runtime (Node is only needed once, at build time). What you lose without the backend is everything that requires a CORS proxy: adding/refreshing playlists via URL and the Xtream/Stalker portal APIs. Browsers block those cross-origin requests, so a small server-side proxy is unavoidable — that's the only reason the Node backend exists. Importing M3U playlists via file upload or pasted text works fully client-side (parsed in the browser, stored in IndexedDB).

One note that applies either way: video playback happens directly in the browser, so streams from providers that don't send CORS headers may not play inline — that's a browser restriction the desktop app doesn't have. In that case you can copy the stream URL from the app and open it in MPV/VLC.

TL;DR: for your own instance the Docker image is the easiest route — one container, nothing to install on the host besides Docker.

[abkoch]

Hello @4gray,

thank you very much for your response.

That's good news for me that IPTVnator can be run without Docker (that's a prerequisite in my environment).

Instead of building it myself i tried just to copy the contents of app/web to the www-root-folder of the configured TLD of my webserver (nginx). Whether on client side nor on server side it shows any error but the result is the following:

It's just showing the title "IPTVnator" and a loading circle but no frontend is loading.

Do i have to perform further configuration?

Best regards
Andreas