PVTKRRX

Quick Jumps

Hard rule: Stremio install is HTTPS-first for remote hosts. HTTP loopback (127.0.0.1) is only for same-device local installs.

For the one-command self-host installer, use curl -fsSL https://www.pvtkrrx.cc/install-selfhost.sh | sudo bash. That launcher stays on the hosted site, installs the branch payload behind the scenes, and falls back to main if a pinned release is too old for the self-host bootstrap script.

Direct-host update: if you clone this repo onto the seedbox or VPS itself, finish with npm run server:setup instead of leaving PVTKRRX on a hand-made node index.js launch. That setup flow writes the saved Remote Seedbox config, self-host password, runtime directory, and the HTTPS install/playback origins that the current server route expects.

Sports operator note: server-route artwork is cache-only during user requests. If sports matters on that box, either let the background seeder warm the runtime automatically or set Sports Poster Package Path and run npm run cache:sports-package. Cache misses fall back to generated posters instead of blocking on live upstream artwork fetches.

Compatibility Matrix

Whatbox Runbook

Configure Page Fields

1. Install or verify qBittorrent and Prowlarr from the Whatbox Manage Apps panel.
2. On your self-host server /configure page, select Remote Seedbox and pick Whatbox from the provider dropdown.
3. Fill in the connection fields using your Managed Links HTTPS URLs:

4. Click Test Connection, then Save.

All three URLs above come from Managed Links in the Whatbox panel. If the Managed Link paths differ from the defaults above, use the exact paths shown in your panel.

ssh user@server.whatbox.ca
mkdir -p ~/apps && cd ~/apps
git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=15000 npm run server:setup

Ultra.cc Runbook

Configure Page Fields

1. Install qBittorrent and Prowlarr from the Ultra.cc app panel.
2. On your self-host server /configure page, select Remote Seedbox and pick Ultra.cc from the provider dropdown.
3. Fill in the connection fields:

4. Click Test Connection, then Save.

Check the exact app paths in your Ultra.cc panel — if the subpaths differ from the defaults above (e.g. a custom Nginx proxy path), use those instead. Run app-ports show over SSH to confirm which ports each app uses.

ssh username@host
bash <(wget -qO- https://scripts.ultra.cc/util-v2/LanguageInstaller/Node-Installer/main.sh)
app-ports free
mkdir -p ~/apps && cd ~/apps
git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=<free-port> npm run server:setup

SeedHost Runbook

Configure Page Fields

1. Install qBittorrent and Prowlarr from SeedHost one-click apps.
2. On your self-host server /configure page, select Remote Seedbox and pick SeedHost from the provider dropdown.
3. Fill in the connection fields:

4. Click Test Connection, then Save.

Check the SeedHost control panel for the exact HTTPS app paths. HD1 plans do not have SSH, so use the Remote Seedbox route with hosted PVTKRRX. If your plan cannot expose a clean HTTPS root route for custom apps, use LAN Bridge instead.

if ! grep -qw "PATH=$HOME/bin" ~/.bashrc ; then mkdir -p ~/bin && echo "PATH=$HOME/bin:$PATH" >> ~/.bashrc && source ~/.bashrc ; fi
cd && wget -q https://nodejs.org/dist/v22.14.0/node-v22.14.0-linux-x64.tar.gz
tar xf ~/node-v22.14.0-linux-x64.tar.gz --strip-components=1 -C ~/
rm -f ~/node-v22.14.0-linux-x64.tar.gz
mkdir -p ~/apps && cd ~/apps
git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=15000 npm run server:setup

Feral Hosting Runbook

Configure Page Fields

1. Install qBittorrent and Prowlarr from the Feral manager or via user-space install.
2. On your self-host server /configure page, select Remote Seedbox and pick Feral Hosting from the provider dropdown.
3. Fill in the connection fields:

4. Click Test Connection, then Save.

Feral save paths start with /media/ instead of /home/. The preset handles this automatically. If your apps are behind proxypass subpaths, use the exact subpath shown in the Feral wiki.

mkdir -p ~/bin && cd
wget -q https://nodejs.org/dist/v22.14.0/node-v22.14.0-linux-x64.tar.gz
tar xf ~/node-v22.14.0-linux-x64.tar.gz --strip-components=1 -C ~/
rm -f ~/node-v22.14.0-linux-x64.tar.gz
mkdir -p ~/apps && cd ~/apps
git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=15000 npm run server:setup

RapidSeedbox Runbook

Configure Page Fields

1. Install qBittorrent and Prowlarr from the RapidSeedbox dashboard (one-click installers on Premium, pre-installed on Lean).
2. On your self-host server /configure page, select Remote Seedbox and pick RapidSeedbox from the provider dropdown.
3. Fill in the connection fields:

4. Click Test Connection, then Save.

Lean plans have no SSH — Remote Seedbox route with hosted PVTKRRX is the only option. Premium plans have SSH and can also self-host PVTKRRX directly. Lean to Premium migration keeps the same provider; switch plan when direct addon hosting becomes needed.

ssh user@<box>.rapidseedbox.com
mkdir -p ~/apps && cd ~/apps
git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=15000 npm run server:setup

Bytesized Runbook

Configure Page Fields

1. Install qBittorrent and Prowlarr from the Bytesized app dashboard.
2. On your self-host server /configure page, select Remote Seedbox and pick Bytesized from the provider dropdown.
3. Fill in the connection fields:

4. Click Test Connection, then Save.

Use the Remote Seedbox route with hosted PVTKRRX first. Bytesized Connect is only needed when you control a server with Docker and root access. If your plan does not provide clean routing for custom app root paths, use LAN Bridge instead.

Swizzin Runbook (Own VPS or Swizzin Provider)

Configure Page Fields

1. Install qBittorrent and Prowlarr via Swizzin (box install qbittorrent prowlarr).
2. On your self-host server /configure page, select Remote Seedbox and pick Swizzin from the provider dropdown.
3. Fill in the connection fields using your reverse-proxy HTTPS URLs:

4. Click Test Connection, then Save.

Swizzin URL subpaths depend entirely on your Nginx reverse proxy config. Use the exact paths from your panel. This is the best option for direct hosting since you control root, Nginx, and domain routing.

git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=7000 npm run server:setup

HostingByDesign Runbook

Configure Page Fields

1. Install qBittorrent and Prowlarr via the box command.
2. On your self-host server /configure page, select Remote Seedbox and pick HostingByDesign from the provider dropdown.
3. Fill in the connection fields:

4. Click Test Connection, then Save.

HBD has SSH and box tooling available on app hosting slots, making it a good option for direct PVTKRRX hosting too. If self-hosting, set PVTKRRX_ALLOWED_WEB_ORIGINS to your exact HTTPS origin.

Other Provider Runbook (Generic)

Configure Page Fields

1. On your self-host server /configure page, select Remote Seedbox and leave provider as Custom / Other.
2. Find the following from your provider's control panel and fill them in:

3. Click Test Connection to verify Prowlarr and qBittorrent respond, then Save.

Only use Remote Seedbox when your Prowlarr, qBittorrent, and file server endpoints are intentionally public over HTTPS and authenticated. If any endpoint is not publicly reachable, use PC Local + LAN Bridge and keep the seedbox as backend only.

git clone https://github.com/Kepners/pvtkrrx.git
cd pvtkrrx && npm ci --omit=dev
PORT=7000 npm run server:setup

Reference Links

Whatbox: Managed Links, Installing Software, SSH
Ultra.cc: Install Node.js, Generic Software, Assigned Ports
SeedHost: Node Install, Shared App FAQ, Available Apps
Feral: Generic Install, Node.js, Proxypass
RapidSeedbox: Lean FAQ, SSH Access, Premium One-Click / Custom
Bytesized: Connect, SSH, Custom App Example
Swizzin: Swizzin Docs, Swizzin GitHub
HostingByDesign: box Basics, App Example