Skip to content
View puqcloud's full-sized avatar

Block or report puqcloud

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
PUQcloud/README.md

PUQ Cloud Panel

PUQ Cloud Panel is an open-source, modular cloud automation and billing system designed to help individuals and companies launch their own IT service business quickly and independently.
Built on Laravel, it includes full billing, provisioning, DNS, cluster management, SaaS deployment, and cloud orchestration β€” all in one platform.

🌐 Official Website | πŸ“š Documentation


🧩 Key Features

  • βœ… Modular Architecture β€” Easily extendable with custom modules.
  • πŸš€ Service Automation β€” Automatic deployment and full lifecycle management.
  • πŸ’³ Advanced Billing System β€” Invoices, proformas, credit balance, multi-currency, tax by region.
  • πŸ›οΈ Product Catalog & eCommerce β€” Sell hosting, SaaS, LXC, services, and physical items.
  • πŸ› οΈ Helpdesk & Support Tools β€” Free or paid support (Remote Hands).
  • 🧾 Multi-company Support β€” Multiple home companies with separate tax profiles.
  • 🌍 Internationalization β€” Taxes, currencies, languages per client country.
  • πŸ—οΈ Cluster Architecture
    • Master nodes management
    • Worker nodes
    • Secure token authorization
    • Automatic syncing
  • 🐳 APP Hosting (SaaS) β€” Deploy SaaS applications on Proxmox clusters automatically.
  • πŸ“¦ LXC Hosting β€” Provision LXC containers as products.
  • πŸ”„ Queue-Based Task Engine β€” Fast background operations.
  • πŸ—„οΈ DNS Manager β€” PowerDNS, HestiaCP, zone migration.
  • πŸ” SSL Manager β€” Let’s Encrypt, ZeroSSL, ACME, EAB support.
  • πŸ”“ Free & Open Source

🎯 Mission

We aim to make cloud business infrastructure available to everyone by providing a powerful, free system for building your IT business.

🫢 Learn more about our vision and philosophy
https://puqcloud.com/puqcloud-panel.php


πŸ‘₯ Community & Contribution

Community Platform β†’ https://community.puqcloud.com/

PUQcloud Panel is developed by international volunteers.

We welcome ideas, bug reports, translations, and module developers.


βš™οΈ Requirements

  • PHP 8.2+
  • MySQL 8.x / MariaDB
  • Redis (queues)
  • Node.js (frontend assets)
  • Composer
  • npm

πŸ”Œ Proxmox Integration Features

PUQcloud provides full automation for Proxmox clusters:

LXC Hosting

  • Create, start, stop, reboot LXC containers
  • Automatic provisioning and termination
  • Custom resource limits
  • Reverse/forward DNS automation

APP Hosting (SaaS Apps)

  • Automatic SaaS deployment on Proxmox
  • Each app runs in isolated environment
  • Multi-cluster support
  • Load balancing and rebalance tools
  • Automatic syncing between clusters

Console Access

Required modules:

noVNC Proxy (for console access of servers and LXC)

Repository:
πŸ”— https://github.com/puqcloud/webproxy

VNC Web Proxy (for APP deployments on Proxmox)

Repository:
πŸ”— https://github.com/puqcloud/vncwebproxy

These tools allow secure, modular console access for both LXC and APP containers.


πŸ› οΈ Fully Automated Installation (Production)

Ready-to-use scripts for installing the PUQcloud Panel:
πŸ‘‰ https://github.com/puqcloud/PUQcloud-Scripts


πŸš€ Installation (Development)

git clone https://github.com/puqcloud/PUQcloud.git
cd PUQcloud
composer install
cp .env.example .env
php artisan key:generate
chmod -R 775 storage bootstrap/cache
npm install
npm run prod

Edit the .env file and fill in the required variables (database, app URL, etc).

Then run this command to create an admin user:

php artisan puqcloud:seed --email admin@example.com --password QWEqwe123 --name Myname

License

PUQcloud is open-source software licensed under the GNU General Public License v3.0.

Authors

Ruslan Polovyi β€” founder and lead developer at PUQ sp. z o.o.

Dmytro Kravchenko β€” Developer / DevOps engineer

Pinned Loading

  1. PUQcloud PUQcloud Public

    Open-source, modular cloud automation and billing system.

    PHP 12 3

  2. PUQcloud-Scripts PUQcloud-Scripts Public

    PUQcloud Panel Automation Scripts

    Shell 2 1

  3. PUQVPNCP PUQVPNCP Public

    Provision and management of WireGuard and IKEv2 VPN servers/accounts via WEB.

    8 1

  4. WHMCS-Addon-PUQ-Customization WHMCS-Addon-PUQ-Customization Public

    WHMCS Addon PUQ Customization

    2

  5. WHMCS-Module-Proxmox-KVM WHMCS-Module-Proxmox-KVM Public

    Provision and manage KVM VM in Proxmox via WHMCS module.

    25 6

  6. WHMCS-WireGuard-VPN WHMCS-WireGuard-VPN Public

    Provision VPN accounts using WireGuard via WHMCS module. Uses only PUQVPNCP

    5 1