QuickStack Installation
This page guides you through installing QuickStack on a fresh Ubuntu server, accessing the UI, and configuring essential ports and security. After following these steps, you'll have a working QuickStack instance ready for first login and app deployment.
What you'll get
A running QuickStack instance with web UI access, ready for app deployment. You'll know the required ports, firewall rules, and first login steps.
Requirements
- OS: Ubuntu 22.04 or newer (other Linux distros not officially supported)
- Specs: Minimum 2 CPU cores, 4 GB RAM, 40 GB disk
- Access: SSH with sudo privileges
- Any Ubuntu VPS works; should have public IPv4
Install (one command)
Connect to your server via SSH and run:
curl -sfL https://get.quickstack.dev/setup.sh | sh -
Choose network interface
- Single-node: select the interface with the public IP.
- Multi-node cluster: select the interface on your private network. See Cluster Nodes for details.
Access the UI
After install, open your browser and go to:
http://your_server_ip:30000
Ports & Firewall
- Inbound: open TCP ports 30000 (UI), 80/443 (ingress)
- Cluster: open TCP 6443 between nodes (if using cluster)
First login
On first access, create the admin user. If you have a domain pointing to your server, enter it; otherwise, use the IP. You can set up a domain later.
After installation: verify health
- UI is reachable at
:30000 - Settings page shows QuickStack version
- No errors shown after install
Security baseline
- Enable HTTPS for your UI domain (Settings → Domains)
- Enable 2FA for the admin account (see guide)
Troubleshooting
- Web UI not reachable:
- Check firewall rules for ports 30000, 80, 443
- Confirm server IP and public accessibility
- Script fails to download:
- Verify internet connectivity
- Cluster nodes not joining:
- Ensure TCP 6443 is open between nodes
- First login fails:
- Try resetting the install and check for error messages