QuickStack Installation

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 24.04
  • Debian 13
  • 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

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.

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
• 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