Self-host

Requirements

Before you install, make sure you have an M3UTool plan of €40 a year or more, an M3UTool key and a machine that can run Docker. This page lists what you need and shows how to create the key. Follow these steps to get everything ready.

What you need

WhatDetails
M3UTool planA paid plan of €40 a year or more on editor.dontv.shop. Self-host does not install without one. It is not part of the free trial.
M3UTool keyA key of the type M3UTool Gateway. It activates your install and unlocks the download. See below.
WindowsWindows 10 or 11, 64-bit, with Docker Desktop. The installer offers to install Docker Desktop for you.
LinuxA 64-bit Linux (x86 or ARM) with Docker Engine and Docker Compose v2.
InternetFor the install (about 400 MB), the daily key check and updates.
Note: Self-host installs on Windows and Linux. There is no version for Mac.

Hardware

MachineProcessorMemory
A desktop or laptop with Docker Desktop4 cores8 GB
A server for a few hundred customers2 cores4 GB

Plan about 3 GB of disk for M3UTool itself, plus roughly 100 MB for every 100,000 streams in your playlists.

Ports

Self-host uses three ports on your machine. When a port is already taken on the first start, M3UTool picks the next free one from the list.

PortUsed forIf it is taken
80Your customers' players (http)8080, then 8088
443Your customers' players over https, with your own domain8443, then 9443
8081The editor, only for you8082, then 8091

Customers who watch from outside your home or office need to reach your machine from the internet: run M3UTool on a server, or forward the customer port on your router. More in Address, domain and HTTPS.

Create your M3UTool key

The installer asks for this key. Create it on editor.dontv.shop.

  1. Open your account: On editor.dontv.shop, click Account at the bottom of the left rail.
  2. Start a new key: In the API keys section, click New key.
  3. Name the key: Type a name in Name, for example "Home server", so you can tell it apart later.
  4. Choose the type: Under What it may do, choose M3UTool Gateway.
  5. Create the key: Click Create key.
  6. Copy the key: Copy the key that starts with dontv_ and keep it somewhere safe. To see it again later, click Show next to the key.
Important: Only paste this key into an install you run yourself. This is so that nobody else can download your account: the key can copy your customers, including their passwords and your provider logins.

If you lose a key that has no Show button (keys made before 6 October 2026), create a new one the same way. To stop a key from working, click the bin icon (Revoke) on its row in the list. More about keys in API.

Pictures show made-up demo channels and Blender open movies (© Blender Foundation, CC BY).