# Getting Started

Welcome to the Self-Hosted Toucan installation guide!

In this guide, you will learn how to install Toucan on your Kubernetes cluster. Whether you're running Toucan for internal business intelligence or embedding it into your customer-facing products, this guide will help you get up and running confidently.

We’ve previously supported deployments through Docker Compose, but as our stack has evolved, so have our deployment practices. With Kubernetes, we gain high-availability, scalability, and a more robust foundation for production-grade workloads. That said, we know Kubernetes can feel overwhelming—especially if you’re just transitioning from v2.

With this guide, we’ll guide you through the steps required to deploy Toucan on your Kubernetes cluster, including prerequisites, configuration, and deployment.

## Why Toucan Self-Hosted?

Self-hosting gives you full control—over your data, your infrastructure, and how you scale. You get to run Toucan on your terms: no vendor lock-in, no surprise limitations, and total transparency. Whether you're a business with strict data policies or a team that just loves tinkering under the hood, self-hosting is empowering.

By the end of this guide, you'll not only have Toucan up and running—you'll also feel more comfortable navigating Kubernetes, one step at a time.

Let’s get started!

{% content-ref url="/pages/wbCYBq6BtPkgmQeXtVx9" %}
[Kubernetes Concepts](/self-hosted-toucan/getting-started/kubernetes.md)
{% endcontent-ref %}

{% content-ref url="/pages/GAo8QRSWPlMn8VmrKyVd" %}
[Prerequisites](/self-hosted-toucan/getting-started/prerequisites.md)
{% endcontent-ref %}

{% content-ref url="/pages/aFQQJs5Doery8KKiVTRg" %}
[Deploy Toucan using Helm Charts](/self-hosted-toucan/getting-started/deploy.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-v3.toucantoco.com/self-hosted-toucan/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.