Documentação

Installing the Edge URL Module (Edge Proxy)

Deploy the Edge URL module on a clean VPS, connect it to Paymenter Proxy Settings, and enable HTTPS URLs for customer stacks.

Edge URL Module
124 views Updated 1 day ago

Installing the Edge URL Module (Simple Version)

The Edge URL Module runs on a separate VPS. It is not installed inside Paymenter.

It adds:

  • Reverse proxy (Traefik)

  • Automatic HTTPS (Let’s Encrypt)

  • API connection with Paymenter for VPS stacks


⚠️ Important

Use a clean VPS only.

Do NOT install it on servers with:

  • cPanel

  • Plesk

  • Existing web servers using ports 80/443


Requirements

  • Ubuntu 22.04+ or Debian 12+

  • Docker installed

  • Public IPv4 address

  • DNS records:

    • edge.yourdomain.com

    • *.edge.yourdomain.com

  • Cloudflare proxy must be OFF (DNS only)


Full Video guide:

Step 1: Setup DNS

Point your domain to the VPS IP:

  • A record → edge.yourdomain.com → VPS IP

  • A record → *.edge.yourdomain.com → VPS IP


Step 2: Upload files

scp -r virtualizor-cloud-edge root@EDGE_IP:/opt/virtualizor-cloud-edge

Step 3: Install module

ssh root@EDGE_IP
cd /opt/virtualizor-cloud-edge
chmod +x install-edge-proxy.sh

export VCE_SSL_EMAIL=admin@example.com
./install-edge-proxy.sh

Save the API token shown at the end.


Step 4: Check if it works

curl -H "Authorization: Bearer YOUR_TOKEN" http://127.0.0.1:8787/api/health

You should see a healthy response.


Step 5: Connect to Paymenter

Go to:

Virtualizor Cloud → Proxy Settings

Fill in:

  • Edge Proxy: ON

  • Edge Domain: edge.yourdomain.com

  • API URL: http://EDGE_IP:8787

  • API Token: (from installer)

  • SSL Email: your email

Test and save.


Step 6: Test a VPS

Create a VPS using a supported stack (WordPress, Coolify, etc.).

After deployment, it should generate a public HTTPS URL automatically.


Help

If something breaks, check DNS first and ensure ports 80/443 are free.