QuickStack Installation

Install (one command)

Connect to your server via SSH and run:

curl -sfL https://get.quickstack.dev/setup.sh | sh -

Requirements

• OS:
  • Ubuntu 24.04 or higher
  • Debian 13 or higher
  • other Linux distros not fully tested
• Specs: Minimum 2 CPU cores, 4 GB RAM, 40 GB disk
• Access: SSH with sudo privileges
• Server should have a public IPv4
  • You can use any server. If you wish to use a cloud provider, we recommend one of the following
    • Hetzner
    • Hostinger
    • Vultr
    • Contabo
    • Linode
    • DigitalOcean

Choose network interface

During the installation, you will be prompted to select the network interface for QuickStack. The choice depends on your setup:

• 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

Make sure the following ports are open in your firewall:

• Inbound: open TCP ports 30000 (UI), 80/443 (ingress)
• Cluster: open TCP 6443 between nodes (if using cluster)

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
• Forgot the password after setup:
  • Reset the password using this guide

Next steps

• Deploy your first app from Git
• Deploy your first app from a Docker image
• Add worker nodes to your cluster