> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/kortix-ai/suna/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-Hosting Overview

> Learn how to deploy and manage your own Kortix instance

## What is Self-Hosting?

Kortix is fully open-source and can be self-hosted on your own infrastructure. This gives you complete control over your data, customization options, and deployment environment.

## Platform Architecture

Kortix consists of four main components that work together:

### Backend API

Python/FastAPI service that powers the agent platform with:

* REST endpoints for agent management
* Thread and conversation management
* Agent orchestration and workflow execution
* LLM integration via LiteLLM (Anthropic, OpenAI, etc.)
* Extensible tool system
* Real-time streaming responses

### Frontend Dashboard

Next.js/React application providing:

* Chat interfaces for agent interaction
* Agent configuration dashboards
* Workflow builders
* Monitoring and analytics tools
* Deployment controls

### Agent Runtime

Isolated execution environments for each agent featuring:

* Docker-based sandboxing
* Browser automation capabilities
* Code interpreter
* File system access
* Tool integration
* Security isolation

### Database & Storage

Supabase-powered data layer handling:

* User authentication and management
* Agent configurations
* Conversation history
* File storage
* Workflow state
* Real-time subscriptions

## Deployment Options

Kortix supports multiple deployment methods:

<CardGroup cols={2}>
  <Card title="Docker Compose" icon="docker" href="/self-hosting/setup#docker-setup">
    Quickest way to get started. All services run in containers with automatic orchestration.
  </Card>

  <Card title="Manual Setup" icon="terminal" href="/self-hosting/setup#manual-setup">
    Run services natively for development or customization. Gives you full control over each component.
  </Card>

  <Card title="AWS ECS/EKS" icon="aws" href="/self-hosting/deployment#aws-deployment">
    Production-grade deployment with auto-scaling, monitoring, and high availability.
  </Card>

  <Card title="Lightsail" icon="server" href="/self-hosting/deployment#lightsail-deployment">
    Simple cloud deployment for small to medium workloads.
  </Card>
</CardGroup>

## Prerequisites

Before self-hosting Kortix, you'll need:

### Required Services

* **Supabase Account** - For authentication and database (cloud or self-hosted)
* **Daytona API Key** - For agent execution environments
* **Composio API Key** - For tool integrations
* **LLM Provider** - At least one of: Anthropic, OpenAI, AWS Bedrock, or OpenRouter

### System Requirements

**For Docker Setup:**

* Git
* Docker (with Docker Compose)
* 4GB+ RAM
* 10GB+ disk space

**For Manual Setup:**

* Git
* Node.js 18+ and pnpm
* Python 3.11+ and uv
* Docker (for Redis)
* 8GB+ RAM
* 20GB+ disk space

**For Production Deployment:**

* AWS account (for ECS/EKS)
* Domain name (optional, for custom URLs)
* SSL certificate (for HTTPS)

## Features

Self-hosted Kortix gives you access to all platform capabilities:

* **AI Agent Creation** - Build custom agents with specialized tools and workflows
* **Browser Automation** - Navigate websites, extract data, automate web workflows
* **File Management** - Create, edit, and organize documents programmatically
* **Code Execution** - Run code safely in sandboxed environments
* **API Integrations** - Connect with external services via Composio
* **Multi-Model Support** - Use different LLM providers for different tasks
* **Real-time Streaming** - Get live responses from your agents
* **Conversation History** - Full chat history and thread management

## Quick Start Path

<Steps>
  <Step title="Clone Repository">
    ```bash theme={null}
    git clone https://github.com/kortix-ai/suna.git
    cd suna
    ```
  </Step>

  <Step title="Run Setup Wizard">
    ```bash theme={null}
    python setup.py
    ```

    The wizard guides you through all configuration steps.
  </Step>

  <Step title="Start Services">
    ```bash theme={null}
    python start.py
    ```

    Access Kortix at [http://localhost:3000](http://localhost:3000)
  </Step>
</Steps>

<Info>
  The setup wizard saves your progress, so you can resume if interrupted. All sensitive data is stored securely in environment files.
</Info>

## What's Next?

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="rocket" href="/self-hosting/setup">
    Detailed setup instructions for Docker and manual deployment
  </Card>

  <Card title="Configuration" icon="gear" href="/self-hosting/configuration">
    Learn about all configuration options and environment variables
  </Card>

  <Card title="Deployment" icon="cloud" href="/self-hosting/deployment">
    Deploy to production environments with AWS
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/self-hosting/troubleshooting">
    Common issues and solutions
  </Card>
</CardGroup>

## Community Support

Need help with self-hosting?

* **Discord** - Join our [community Discord](https://discord.com/invite/RvFhXUdZ9H) for real-time support
* **GitHub Issues** - Report bugs and request features on [GitHub](https://github.com/kortix-ai/suna/issues)
* **Twitter** - Follow [@kortix](https://x.com/kortix) for updates