Fleet hypervisor A
Guest outbound traffic uses this hypervisor’s NAT.
One-Click is a shell-native Linux control plane for fleets, KVM virtual machines, networking, DNS and isolated application hosting — turning repetitive administration into explicit, repeatable workflows.
Open source · MIT licensed · SSH-first · no permanent web control panel required
___ ____ _ _ _ / _ \ _ __ ___ / ___| (_) ___| | __ | | | | '_ \ / _ \ | | | | |/ __| |/ / | |_| | | | | __/ | |___| | | (__| < \___/|_| |_|\___| \____|_|_|\___|_|\_\ ___ _ _ _ _ |_ _|_ __ ___| |_ __ _| | | ___ __| | | || '_ \/ __| __/ _` | | |/ _ \/ _` | | || | | \__ \ || (_| | | | __/ (_| | |___|_| |_|___/\__\__,_|_|_|\___|\__,_| [SUCCESS] One-Click Is Now Installed!
See how One-Click prepares a host, creates a guest and publishes its services through that host’s own edge proxy.
Follow a NAT Linux VPS from controller setup to a published service. Expand each stage for the commands and decisions involved.
Run from the intended controller. Add the target hypervisor by its reachable address and verify SSH/Ansible access before provisioning.
one-click fleet init
one-click fleet add <hypervisor-ip> hypervisor1 [ssh-port]
one-click fleet list
one-click fleet verifyConfirm hardware virtualisation, recovery-console access, storage capacity and the host network plan. Review ENABLE_VPS and the allocation settings in /usr/local/bin/one-click. The VPS entry point offers to enable the feature if it is disabled. Preparation can change host bridges and network services, including when starting with a NAT guest.
sudoedit /usr/local/bin/one-clickChoose a unique name, a Fleet hypervisor, an image, CPU, RAM, disk and network mode. This Linux example omits --password and uses the Fleet SSH key. Supply your own values and use a supported image profile.
one-click --vps create --target hypervisor1 --name web1 --image debian13 --cpu 2 --ram 2048 --disk 20G --mode natThe create workflow resolves the image and checks the selected host. If its virtualisation environment is missing, One-Click invokes setup within that workflow. Confirm the initialisation prompt only after reviewing the host plan. Setup prepares controller tracking, address pools, WireGuard configuration and the target KVM/libvirt networks. Subsequent creations reuse the prepared environment.
Provisioning checks target resources, prepares guest storage and configuration, creates the libvirt guest and waits for network access. The path varies by image: Linux cloud-image provisioning, installation media and Windows builds have different stages. Larger downloads and OS installations take longer.
Inspect the guest and its owning hypervisor, confirm Fleet registration and test SSH. Check the hypervisor network and guest service before exposing a workload. If libvirt contains the VM but the inventory does not, investigate registration before creating it again.
one-click --vps list
one-click --vps info web1
one-click fleet list
one-click fleet verify
one-click --ssh web1For NAT guests, configure HAProxy on the owning hypervisor after the guest service is running. DNS points to that hypervisor’s public address. This HTTPS example forwards to port 443 in the guest, where its web server presents the certificate.
one-click proxy --target web1 --website app.example.org --proto https
one-click --vps snapshot create --target web1 --name before-changeFleet inventory, SSH/Ansible orchestration and VPS operations
Guest outbound traffic uses this hypervisor’s NAT.
Guest outbound traffic uses this hypervisor’s NAT.
Private IP connectivity follows the configured peer routes. Separate hypervisors keep separate NAT networks and public addresses.
The controller can also host guests when configured as a hypervisor. WireGuard connectivity does not move a public IP or provide service failover; availability depends on the configured routing and recovery design.
Keep the operating system visible while automating the repetitive parts of fleet, virtualisation, DNS, security and application operations.
Register, verify, audit and operate remote Linux nodes through controller-driven Ansible and SSH trust.
Explore →Move workloads between managed fleet members and external Linux hosts through the Fleet portability workflow.
Explore →Operate DNS through BIND or API-backed providers including Cloudflare, from the same terminal-led workflow.
Explore →Provision and operate NAT or public KVM guests across suitable controller and fleet hosts.
Explore →Translate intent into validated firewall changes with previews, critical-port protection and native-rule access.
Explore →Deploy and manage WordPress, Nextcloud, static/PHP sites and Node.js apps with separate site environments and shared HTTPS management.
Explore →One-Click reduces repetitive command work while preserving normal Linux tools, files and services underneath.
Routine administration stays SSH-first. Temporary browser surfaces are created only when a workflow needs one.
Cloudflare joins BIND and other API providers as a DNS workflow, so public DNS operations can stay in the same operational model.
Import/export makes workload transfer a fleet operation, keeping inventory, trust and orchestration relationships central instead of maintaining a separate migration path.
Ansible, KVM, WireGuard, HAProxy, Nginx, Apache, PHP-FPM and standard Linux services remain visible and inspectable.
One-Click keeps the setup path explicit: fetch the public bootstrap, validate the host, prepare only what is missing, load the module cache and enter the managed shell. The same Linux primitives remain visible throughout.
Fetch one-click.sh and invoke setup.
Detect the Linux family, privileges and host state.
Install missing dependencies and initialise state.
Refresh or reuse the bounded module cache.
Enter the managed System, Security, Web, Fleet and Network domains.
curl -fsSL https://raw.githubusercontent.com/SiteHUB-NG/One-Click/main/one-click.sh -o /tmp/one-click.sh && bash /tmp/one-click.sh setup && rm -f /tmp/one-click.shGo deeper into the operations that follow deployment.
Practical walkthroughs, troubleshooting advice and ideas for managing Linux infrastructure with One-Click.
A practical operating model for provisioning KVM guests with NAT or public networking and keeping recovery at the hypervisor layer.
Security · 2026-11-17How to use local SSH evidence, timed restrictions and external context together without treating scores as proof.
Automation · 2026-11-16How to structure repeatable Linux operations around commands, grouped menus and visible native system state.
Architecture · 2026-11-12Why a shell-native control plane can organise Linux operations without requiring a permanent browser-based management appliance.