Installing Virtualizor Cloud Module on Paymenter

This guide covers the full installation process for the Virtualizor Cloud Module on Paymenter.

The package includes two core extensions:

1. Virtualizor Cloud Manager (VirtualizorCloudManager)
   Handles admin catalog, launch system, stacks, billing logic, and edge proxy integration.

2. Virtualizor Cloud Server Extension (VirtualizorCloud)
   Manages VPS provisioning and lifecycle operations directly on Virtualizor.

Both extensions are required and must be installed and enabled.

---

Requirements

Before installation, ensure your environment meets the following:

• Paymenter 1.2 or newer (latest stable recommended)

• PHP 8.2 or 8.3+

• MySQL 8.0+ or MariaDB 10.6+

• Virtualizor master server with Admin API enabled

• Valid SSL certificate on your Paymenter domain (required for OAuth licensing)

• Composer dependencies already installed on your Paymenter instance

---

Video Guide (Optional)

For a visual walkthrough, watch:

---

Step 1: Download

1. Go to My Account → Downloads on Gashfix.dev or your BuiltByBit purchase page

2. Download Virtualizor-Cloud-Modulev100.zip (or latest available version)

3. Extract the archive locally

4. Confirm the structure includes:

• extensions/Others/VirtualizorCloudManager

• extensions/Servers/VirtualizorCloud

---

Step 2: Upload to Paymenter

Copy the extensions into your Paymenter installation:

cp -r Virtualizor-Cloud-Modulev100/extensions/Others/VirtualizorCloudManager /path/to/paymenter/extensions/Others/
cp -r Virtualizor-Cloud-Modulev100/extensions/Servers/VirtualizorCloud /path/to/paymenter/extensions/Servers/

Set correct ownership for the web server user:

chown -R www-data:www-data /path/to/paymenter/extensions/Others/VirtualizorCloudManager
chown -R www-data:www-data /path/to/paymenter/extensions/Servers/VirtualizorCloud

---

Alternative: Admin Upload

If supported by your Paymenter version:

Extensions → Upload

Then enable both extensions.

---

Run Migrations & Clear Cache

After installation, execute:

cd /path/to/paymenter
php artisan migrate
php artisan optimize:clear

---

Step 3: Activate License

In Paymenter Admin Panel, navigate to:

Virtualizor Cloud → Module Activation

Click Activate with Gashfix Account and complete the authentication process.

License format:

GFX-XXXX-XXXX-XXXX-XXXX

When using OAuth activation, manual key entry is not required.

If purchased via BuiltByBit, create a Gashfix account and contact gashfix.dev/support with proof of purchase to receive license assignment.

---

Step 4: Configure Virtualizor

1. Go to Servers → Create in Paymenter Admin

2. Select Virtualizor Cloud extension

3. Fill in configuration fields:

• Panel URL: Virtualizor master server URL

• API Key: Virtualizor Admin API key

• API Password: Virtualizor Admin API password

4. Save configuration

5. Test connection if available

6. Open Virtualizor Cloud → Settings and review defaults (regions, nodes, sync options)

---

Step 5: Create Products

1. Navigate to Virtualizor Cloud → Cloud Products (or catalog section)

2. Create product types (fixed, slider, or PAYG)

3. Assign regions, OS templates, and pricing rules

4. Link the product to the Virtualizor Cloud server extension

5. Publish the product

---

Verification

After setup, create a test order and confirm:

• VPS is automatically provisioned in Virtualizor

• Service appears in the client dashboard

• Virtualizor Cloud → Overview loads without redirecting to activation

• Client launch page works (if enabled)

• Suspend and unsuspend actions work correctly from billing system

---

Support

If you encounter any issues during installation:

Open a ticket at gashfix.dev/support and include your Virtualizor Cloud Module purchase details.