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.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, 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 empower individuals and companies to start their IT service business quickly and independently. Built on Laravel, it provides advanced billing, provisioning, service management, and cloud orchestration features β€” all in a single system.

🌐 Official Website | πŸ“š Documentation


🧩 Key Features

  • βœ… Modular Architecture β€” Easily extendable with custom modules.
  • πŸš€ Service Automation β€” Automatically deploy and manage cloud services.
  • πŸ’³ Advanced Billing System β€” Invoices, proformas, add funds, taxation by region.
  • πŸ›οΈ Product Catalog & eCommerce β€” Sell services and physical items.
  • πŸ› οΈ Helpdesk & Support β€” Manage paid or free technical support (Remote Hands).
  • 🧾 Multi-company Support β€” Manage multiple home companies under one panel.
  • 🌍 Internationalization β€” Tax rules, currencies, languages per client country.
  • πŸ—οΈ Cluster Support β€” Node orchestration with master/agent communication.
  • πŸ”„ Queue-Based Task Handling β€” Fast and reliable job processing in background.
  • πŸ”“ Free & Open Source

🎯 Mission

Our mission is to democratize cloud business infrastructure by giving everyone the tools to run their own IT business β€” for free.

🫢 Learn more about our goals and philosophy


πŸ‘₯ Community & Contribution

PUQ Cloud Panel is built and maintained by a global community of volunteers.

  • πŸ’‘ Want to contribute code? Fork the repo and submit a PR.
  • 🀝 Want to help in other ways? Join as a Volunteer
  • πŸ’° Want to support us? Become a Sponsor

We welcome all types of contributions β€” code, documentation, translations, bug reports, and ideas.


βš™οΈ Requirements

  • PHP 8.2 or higher
  • Laravel 12+
  • MySQL 8.x or MariaDB
  • Redis (for queues)
  • Node.js (for frontend assets, optional)
  • Composer
  • npm

πŸš€ 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 5 2

  2. PUQcloud-Scripts PUQcloud-Scripts Public

    PUQcloud Panel Automation Scripts

    Shell 2

  3. PUQVPNCP PUQVPNCP Public

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

    5 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.

    24 6

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

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

    3 2