One CLI to rule them all: Manage Proxmox hosts, deploy LXC containers,
and run Docker applications - all from a single unified interface.
Install anything on your Proxmox infrastructure with simple commands.
# Install and run your first container
git clone https://github.com/fabriziosalmi/lws.git
cd lws && pip install -r requirements.txt
lws lxc run --image-id ubuntu-22.04 --size medium --count 3From Bare Metal to Running Applications in 3 Simple Steps
Manage your Proxmox hosts
lws px list
Deploy containers instantly
lws lxc run --size medium
Run any application
lws app deploy install
# 1. Create LXC container
lws lxc run --image-id ubuntu-22.04 --size lws-web --hostname wordpress-1
# 2. Install Docker in the container
lws app setup 100
# 3. Deploy WordPress with Docker Compose
lws app deploy install 100 --compose-file wordpress-compose.yml
# Done! Your WordPress is running 🎉Everything you need to manage your Proxmox infrastructure
Optimized command execution with SSH connection pooling and retry logic
Built-in security groups, firewall rules, and credential masking
Manage containers across multiple Proxmox hosts and availability zones
Real-time CPU, memory, and disk monitoring with scaling recommendations
Install and manage Docker containers within LXC containers
Intelligent resource scaling based on usage patterns and thresholds
Snapshot management and full container backup/restore capabilities
Full-featured REST API with Swagger documentation and Web UI
pip install -r requirements.txtcp config.yaml.example config.yaml
# Edit config.yaml with your Proxmox detailslws lxc run --image-id ubuntu-22.04 --size mediumInstallation, configuration, and your first steps with LWS
Learn about the modular design and internal structure
Complete command reference with examples
REST API endpoints and usage guide
Advanced configuration options and best practices
How to contribute to the project