Deploy

Caution

USERS!

Please use the extension instead unless you are familiar with self hosting Docker images!

Caution

Selfhosting the client as well?

Please read THIS and use Method 1 (Docker) or Method 2 (Manual)!

Cloudflare and Netlify’s IPs are blocked by most sites and the proxy MUST be hosted on a VPS or other server that is not IP/ASN banned.

Method 1 - Docker (Recommended)

This is the recommended method for deploying on a VPS or home server. Experience with Docker, domains and web hosting is recommended.

Caution

Experience with Docker, domains and web hosting is highly recommended for this method. You are exposing your server at your own risk!

P-Stream does not have a Docker image for the proxy, but there is a Dockerfile within the repo.

1. Clone the repo on your server: git clone https://github.com/okikio/mov-proxy

2. Locate the Dockerfile in the root folder.

3. Build the Docker image: docker build -t mov-proxy ./mov-proxy

4. (Optional) Create and edit a .env file in the mov-proxy directory to configure secrets such as JWT_SECRET and other environment variables as documented in the configuration guide.

5. Run the Docker container (replace values as needed): docker run -d --name mov-proxy -p 3000:3000 --env-file .env mov-proxy

6. (Optional) Configure your firewall or reverse proxy (such as NGINX or Caddy) to expose port 3000 or your desired HTTP/HTTPS port.

The container exposes the HTTP port (Without TLS/SSL) as 3000/TCP.

Method 2 - Manual (Advanced)

This method is for advanced users who want full control over their deployment. We recommend using automated package managers like nixpacks for easier deployment.

Manually installing the proxy on your server. You may want to use an automated package manager like nixpacks to do this.

1. Clone the repo on your server git clone https://github.com/okikio/mov-proxy

2. Navigate to the directory cd mov-proxy

3. Install packages pnpm i

4. Build the app pnpm build

5. Start the proxy pnpm start

You’ll need to configure port forwarding and firewall settings. Good luck.

---

Deprecated Methods

Caution

These methods are DEPRECATED and should not be used for new deployments. Cloudflare, Netlify, and Railway IPs have been heavily abused and are now blocked by most streaming sites. Use Docker or Manual deployment on a VPS or home server with a residential/private IP instead.

Method 3 - Cloudflare (DEPRECATED)

Cloudflare has a generous free plan, so you don’t need to pay anything unless you get thousands of users.

1. Create a GitHub account at https://github.com if you don’t have one.

2. Click the Deploy with workers button above.

3. Configure any additional settings if desired.

4. Click Deploy to deploy to Cloudflare Workers.

5. Congratulations! Your worker is now deploying. Please wait for the GitHub Action to build and publish your worker.

6. You can click the Worker dash and GitHub repo buttons to see the status of the deploy.

7. When the worker has deployed, you will need to take note of the URL. This can be found on Cloudflare under Workers and Pages -> Overview -> Proxy.

8. Use the URL you took note of and set up a custom proxy in the client.

Method 4 - Netlify (DEPRECATED)

Netlify has a very generous free plan, so you’ll be able to host your proxy for free unless you get hundreds of users.

1. Create a GitHub account at https://github.com/signup if you don’t have one already.

2. Click on the Deploy to Netlify button above. Authorize Netlify to connect with GitHub by clicking the Connect to GitHub button.

3. There should now be a Save & Deploy button, click it.

4. Once the deployment is complete, click on the Get Started button that pops up, this will redirect you to the dashboard of your site.

5. Click on the only site in the Sites section of your dashboard.

6. Find the link of your site near the top of the page, it should look something like https://<random-words>.netlify.app. Right click the link, click Copy link address. Now you’ll just have to set up the client!

Method 5 - Railway (DEPRECATED)

Railway provides $5 in free credits once you verify your account. These credits expire after 1 month and are usually enough to keep the proxy running for about that time. (Tip: You can delete your account and create a new one to receive additional credits.)

1. Login to your Railway account if you have one, otherwise create one here.

   • If you are signing up, then verify your account by clicking the link in the email Railway sends you.
   • If you created your account with an email, then to verify your account further, go to your account, then plans and verify your account with a GitHub account.

2. Click the Deploy on Railway button above.

3. If a Configure button is displayed, click on it and allow Railway to access your GitHub account.

4. The Deploy button at the bottom of the template should be active, click on it.

5. Once the proxy has deployed, copy the URL from the Deployments page.

6. Congratulations! You have deployed the proxy, you can now set up the client.