Install WolfStack
One command. Any Linux server. Up and running in under 10 minutes.
Install on Your Server
Run the installer on every server you want to manage. Repeat this on each node in your cluster. Works on Ubuntu, Debian, Fedora, RHEL, Arch, openSUSE, and Proxmox VE.
curl and sudo are installed
Most servers have these pre-installed. If yours doesn’t (common on minimal/container images), run the command for your distro first as root:
apt install -y sudo curldnf install -y sudo curlpacman -S --noconfirm sudo curlzypper install -y sudo curlcurl -sSL https://raw.githubusercontent.com/wolfsoftwaresystemsltd/WolfStack/master/setup.sh | sudo bashWhat the installer does
- Detects your distro and installs runtime dependencies — by default Docker, LXC, KVM/QEMU and the Proxmox Backup client (pick which of these you want with
--minimal, see below) - Downloads the pre-built WolfStack binary for your architecture
- Installs WolfNet (encrypted mesh networking)
- Sets up the web UI and config directory
- Creates a systemd service (auto-starts on boot)
- Generates TLS certificates
Install options
Pass flags through the pipe with -s --. For a lightweight box — say a Raspberry Pi print server that just wants the monitoring UI — use --minimal to choose exactly which runtimes get installed:
curl -sSL https://raw.githubusercontent.com/wolfsoftwaresystemsltd/WolfStack/master/setup.sh | sudo bash -s -- --minimal| --minimal | Interactively pick which optional runtimes to install — Docker, LXC, KVM/QEMU and the Proxmox Backup client. The WolfStack binary plus its monitoring, networking and storage helpers are always installed, so you still get the full dashboard. Without this flag, all runtimes are installed (unchanged from before). Combined with --yes, or when there’s no terminal to prompt, it installs the core only. |
| --yes | Unattended — skip all prompts (also -y). |
| --beta | Install the beta release channel instead of stable. |
| --install-dir <path> | Install to a custom directory. |
| --skip-pbs-build | Don’t compile the Proxmox Backup client from source on architectures without a prebuilt binary. |
| --agent | Agent mode — register this node against an existing cluster (headless). |
How to set up a WolfStack cluster (or standalone)
WolfStack is the same binary whether you run one server or fifty — you just install it on each box and tell each instance about the others. There is no controller, no separate “manager” node, no licensing tier change.
Standalone (one server)
- Run the installer above on your one server.
- Open
https://your-server-ip:8553in a browser. - Log in with your existing Linux user credentials (PAM — the same username/password you use to SSH).
- Done. Manage Docker, LXC, VMs, storage, networking, and everything else from that one dashboard.
Cluster (two or more servers)
- Install WolfStack on every node using the command above. Each node now has its own dashboard at
https://<node-ip>:8553. - Pick any installed node as your starting point and open its dashboard.
- Click the + button at the bottom of the left sidebar to open the Add Server dialog.
- For each other node you want to add:
- In another browser tab, open that node’s dashboard and click its + button. The bottom of its Add Server dialog shows its join token — copy it. (Or run
wolfstack --show-tokenon that node from the shell for the same value.) - Back on your starting node, paste the token into the Join Token field, enter the other node’s address, and click Add Server.
- In another browser tab, open that node’s dashboard and click its + button. The bottom of its Add Server dialog shows its join token — copy it. (Or run
- Repeat step 4 for each remaining node. Cluster membership propagates automatically — once a node is joined, every other node learns about it via gossip.
- When all nodes are joined, go to Cluster Settings → Update WolfNet Connections to bring up the encrypted mesh between them.
Coming from the old Proxmox API integration? That has been removed in v22.2.0. Install WolfStack on each Proxmox host using the command above and add them as regular WolfStack nodes — the dashboard will auto-clean any leftover Proxmox-only entries on first restart.
Supported Platforms
System Requirements
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 1 core (x86-64 or ARM64) | 2+ cores |
| RAM | 1 GB | 2+ GB |
| Disk | 10 GB | 50+ GB (SSD) |
| Network | 1 NIC | Gigabit Ethernet |
Virtual Machine Support
WolfStack runs in any virtualisation platform:
- Proxmox VE — install inside a VM or directly on the host
- VirtualBox — spin up a Linux VM and run the installer
- VMware — ESXi, Workstation, or Fusion
- KVM/QEMU — use virt-manager or command line
- Hyper-V — create a Gen 2 VM
Just want to try it out? The Live USB lets you boot WolfStack from a USB stick without installing anything. Great for testing and evaluation.
Need help setting up?
Our team can set up your entire WolfStack cluster for you.