Download the PHP package beziworld/laravel-proxmox without Composer
On this page you can find all versions of the php package beziworld/laravel-proxmox. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download beziworld/laravel-proxmox
More information about beziworld/laravel-proxmox
Files in beziworld/laravel-proxmox
Package laravel-proxmox
Short Description Laravel client for the Proxmox VE API: nodes, QEMU VMs, LXC containers, snapshots, backups, storage, tasks with a UPID waiter, cluster resources and access, for many clusters.
License MIT
Homepage https://github.com/beziworld/laravel-proxmox
Informations about the package laravel-proxmox
Laravel Proxmox VE
Laravel client for the Proxmox VE API: nodes, QEMU virtual machines and LXC containers (lifecycle, configuration, cloning, snapshots, backups, migration), storage, asynchronous tasks with a UPID waiter, cluster resources and access control, for one or many clusters.
Polska wersja dokumentacji
Features
- API tokens (
PVEAPIToken=user@realm!id=secret) or username/password tickets with theCSRFPreventionToken, cached and renewed automatically - Multiple named clusters plus
using([...])for clusters stored in your database - TLS verification on by default, per connection
verify_ssltrue, false or a CA bundle path (/etc/pve/pve-root-ca.pem) - Guests addressed by VMID:
Proxmox::vm(100)finds the node in the cluster resources - Every asynchronous call returns a
Task(UPID) withwait(),status(),log()andstop(); failures raiseTaskFailedwith the last log lines, long tasksTaskTimeout - Typed DTOs (
Node,ClusterResource,GuestStatus,Snapshot,TaskStatus,Storage,StorageVolume,ApiToken,User) that keep the raw payload - Reads retried on connection errors, HTTP 5xx and 595/596, writes never retried; validation errors exposed per parameter
php artisan proxmox:checkandphp artisan proxmox:task {upid}- PHP 8.3+, Laravel 12 and 13, PHPStan level 8, works with
Http::fake()andSleep::fake()
Why this package
On Packagist (November 2026) corsinvest/cv4pve-api-php has about 1.37M downloads: a complete generated client,
framework-agnostic and curl-based. Laravel packages are rare: irabbi360/laravel-php-proxmox (about 4.6k downloads)
always disables TLS verification, supports only password tickets for a single server and has no task handling;
h1g/proxmox (160 downloads) is a 2016 Laravel 5 binding. This package adds:
- API token authentication and ticket caching shared by queue workers
- several clusters, each with its own credentials, node and TLS settings
- a UPID task waiter, so provisioning flows (clone, configure, start) can be written top to bottom
- Laravel's HTTP client (testable with
Http::fake()), typed exceptions and DTOs
Installation
API tokens with privilege separation only hold the permissions granted to the token itself: grant a role (for
example PVEVMAdmin on /vms and PVEDatastoreUser on /storage) to the token, not only to its user.
More clusters go into config/proxmox.php:
Usage
Provision a VM from a template
Lifecycle
Snapshots and backups
Tasks (UPID)
Nodes, cluster and storage
Access control
Runtime clusters and anything else
Exceptions
All exceptions extend Beziworld\Proxmox\Exceptions\ProxmoxException:
| Exception | When |
|---|---|
AuthenticationException |
Token, ticket or login rejected (HTTP 401). A rejected login is never repeated. |
PermissionDenied |
Missing privilege (HTTP 403) |
ApiException |
Other error status; httpStatus(), errors() (per parameter), payload() |
RateLimitException |
HTTP 429 from a proxy in front of the cluster; retryAfter() |
ConnectionFailed |
DNS, TCP, TLS or timeout error (after read retries) |
TaskFailed |
wait() saw an exit status other than OK; status() and the last log lines |
TaskTimeout |
wait() gave up; the task keeps running (upid()) |
GuestNotFound |
VMID not in the cluster resources (or not visible to the token) |
InvalidConfiguration |
Unknown connection, missing URL, credentials or node |
Notes
- Calls are synchronous and tasks such as clones, backups and migrations take minutes: run them in queued jobs and
keep the UPID, or use
wait()with a timeout that fits the job. updateConfig()uses the asynchronous POST endpoint for VMs (needed for hotplug and disk allocation) and returns a task only when Proxmox started one.- Two-factor authentication is not supported for ticket logins: use an API token.
Development
Author
Created and maintained by Kamil Ćwiertnia, beziworld.eu.
- E-mail: [email protected]
- Issues and feature requests: GitHub issues
- Security vulnerabilities: see SECURITY.md
Need an integration? Get in touch through beziworld.eu.
Other packages by the author
- beziworld/laravel-directadmin: DirectAdmin hosting panel
- beziworld/laravel-plesk: Plesk hosting panel
- beziworld/laravel-unifi: UniFi Network
License
MIT. See LICENSE.md. This package is not affiliated with, endorsed by or sponsored by Proxmox Server Solutions GmbH. Proxmox is a registered trademark of Proxmox Server Solutions GmbH.
All versions of laravel-proxmox with dependencies
ext-json Version *
guzzlehttp/guzzle Version ^7.8
illuminate/cache Version ^12.0|^13.0
illuminate/collections Version ^12.0|^13.0
illuminate/console Version ^12.0|^13.0
illuminate/contracts Version ^12.0|^13.0
illuminate/http Version ^12.0|^13.0
illuminate/support Version ^12.0|^13.0