Architecture

Understanding knot architecture helps you design effective deployments.

Core Components

Server The knot server provides the web interface, API, and manages all resources. It stores data in a database and coordinates with agents.

Agent The agent runs inside containers and communicates with the server. It handles SSH, terminal access, and space lifecycle commands.

Database Stores users, templates, spaces, and configuration. Options: BadgerDB, MySQL/MariaDB, or Redis/Valkey.

Container Runtime Executes spaces. Options: Docker, Podman, Nomad, or Apple Container.

Topics

• Deployment Modes - Standalone, cluster, and leaf configurations
• Cluster Architecture - Leaderless design and data flow
• Network Architecture - Ports, communication, and security
• Scalability - Scaling strategies and performance