📘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!

☸️Kubernetes Concepts✅Prerequisites⛴️Deploy Toucan using Helm Charts