Self-host ɳTV

Provision a VPS

Any Linux VPS works. Hetzner CX22 (2 vCPU, 4 GB RAM) is the recommended minimum for transcoding. Ubuntu 22.04 or Debian 12.

At least 20 GB storage for Docker images. Add more for your media library.

Install ɳSelf

Run the installer on your server. It installs Docker, the ɳSelf CLI, and sets up the base stack.

curl -sSL https://install.nself.org | bash
nself init my-media-server

Set your license key

Paste your ɳTV Bundle key (from nself.org/account). This enables the paid plugins.

nself license set nself_pro_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Get a key at nself.org/pricing. The $0.99/mo ɳTV Bundle is the minimum required tier.

Install ɳTV Bundle plugins

Install all 11 bundle plugins in one command. Companion plugins install automatically.

nself plugin install \
  media-processing streaming epg tmdb \
  podcast recording game-metadata \
  file-processing subtitle-manager vpn stream-gateway

Build and start

ɳSelf generates the Docker Compose file and starts all services.

nself build
nself start

First start pulls Docker images, takes a few minutes depending on your connection.

Configure your media path

Tell ɳTV where your media files live on the server.

nself config set MEDIA_PATH=/data/media
nself restart media-processing

Open ɳTV and connect

Download the ɳTV app for your platform, enter your server URL, and sign in.

# Your server URL is printed by:
nself info

# In ɳTV app:
# Settings > Add Server > https://your-server.example.com