Install

Option 1: CLI install (recommended for local or self-hosted use)

Three commands bring the full platform live.

# 1. Install the Kortix CLI
curl -fsSL https://kortix.com/install | bash

# 2. Scaffold a new project (creates kortix.toml + agents, skills, and runtime config)
kortix init

# 3. Ship it: push your repo and bring the whole thing live in the cloud
kortix ship

After kortix ship, the CLI prints the URL of your live command center.

Option 2: Self-hosted via Docker (no Kortix Cloud)

Run a production-style local instance from Docker images, then toggle between Cloud and your own host:

kortix self-host start
kortix hosts use local     # switch CLI target to local instance
# to switch back:
kortix hosts use cloud

The first interactive setup asks only for integration credentials (managed git, GitHub access, Pipedream connectors). Ports, local URLs, encryption keys, and Docker Compose defaults are generated automatically.

Option 3: Zero-install (Kortix Cloud)

No install required. Sign up at kortix.com, create a project, and start a session from the web dashboard. Use this path to evaluate Suna before committing to a self-hosted deployment.

Local development (contributing or forking)

The monorepo uses pnpm. You need Node.js, pnpm, and Docker Desktop.

git clone https://github.com/kortix-ai/suna.git
cd suna
pnpm install

# Run the full local stack (web + API + sandbox)
pnpm dev

# Or run individual apps
pnpm dev:web        # Next.js web app only
pnpm dev:api        # API only
pnpm dev:sandbox    # build the local sandbox image

Secrets for local dev are encrypted with dotenvx and committed to the repo. To decrypt them locally:

curl -sfS https://dotenvx.sh/armor | sh   # one-time install
dotenvx-armor login                        # grants this machine decryption rights
pnpm dev                                   # scripts/dev-local.sh decrypts .env on boot

Prerequisites

Requirement	Details
Node.js	v20+ (for local dev)
pnpm	v9+ (monorepo package manager)
Docker Desktop	Required for self-hosted or sandbox dev
Git	Required for change-request workflow
Kortix CLI	Installed via the curl script above