Quick Start

Get knot running in minutes. Choose the deployment path that matches your needs.

Deployment Options

Local Containers

Recommended for most users

• Single Server: Quick setup on one machine with Docker, Podman, or Apple Containers
• Multi-Server: Scale across multiple servers with automatic node selection and load balancing
• No orchestrator required: No Nomad, Kubernetes, or other dependencies needed
• Setup time: 5-10 minutes

Best for:

• Individual developers
• Small to medium teams
• Quick testing and evaluation
• Multi-server setups without Nomad complexity

Nomad Cluster

For enterprise-scale deployments

• Leverage existing Nomad infrastructure
• CSI storage drivers and ingress controllers
• Advanced job constraints and scheduling
• Setup time: 30+ minutes

Best for:

• Production deployments
• Large teams
• High availability needs
• Organizations with existing Nomad infrastructure

Quick Comparison

What You’ll Learn

Local Containers Path:

1. Install knot binary
2. Configure server
3. Create admin user
4. Create first template
5. Launch first space
6. Access via web terminal

Nomad Path:

1. Install knot binary
2. Configure for Nomad
3. Deploy to cluster
4. Create admin user
5. Create Nomad template
6. Launch space in cluster

What’s Next

After completing quick start:

• Configure access control
• Create more templates
• Set up multi-server clusters
• Enable security features