Self-hosting overview

Review the requirements, deployment model and operational responsibilities for running the source-available Portal Heaven web player.

Requirements

Node.js 22 LTS
Supported SQLite and persistent storage
A reverse proxy such as nginx
HTTPS certificates for authentication pages
Environment variables for secrets, CAPTCHA and public URLs

Deployment model

Build the Vite frontend, run the Node backend as a supervised service, serve static assets from the build directory and proxy only documented backend routes. Keep the HTTP content host isolated from authentication cookies and HTTPS-only account operations.

License

The source is published under the PolyForm Noncommercial 1.0.0 license. Review the license before deployment; commercial use requires separate permission from the copyright holder.

Operational responsibility

Self-hosters are responsible for access control, backups, updates, monitoring, provider authorization, local law and the bandwidth consequences of enabling a media relay.

Source

Review the code and deployment documentation in the Portal Heaven repository.