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

# Overview

> Overview of the self-hosted edition of Bilanc.

Bilanc offers a self-hosted deployment option for customers who need full control over their infrastructure. This guide covers deployment, scaling, updates, and other key operational details.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/self-hosting/quickstart">
    Get up and running in 5 minutes
  </Card>

  <Card title="Configuration" icon="gear" href="/self-hosting/configuration">
    Environment variables and tenant setup
  </Card>

  <Card title="Integrations" icon="plug" href="/self-hosting/integrations">
    Connect GitHub, Linear, and Cursor
  </Card>

  <Card title="Infrastructure" icon="server" href="/self-hosting/infrastructure">
    Architecture and components
  </Card>
</CardGroup>

## Features

All paid features available on Bilanc Cloud are included in the Enterprise self-hosted edition.

## Plan Requirement

A Bilanc subscription is required. Contact us to get started.

## Intended Users

Optimised for large, regulated enterprises that require:

* Full control over data residency
* Custom security and compliance requirements
* Integration with existing infrastructure

## Prerequisites

Before deploying Bilanc, ensure you have:

<Steps>
  <Step title="Docker & Docker Compose">
    Docker and Docker Compose v2+ installed on your system
  </Step>

  <Step title="Registry Access">
    Access to the Bilanc self-hosted Docker image (contact a Bilanc team member)
  </Step>

  <Step title="Google Cloud CLI">
    [gcloud CLI](https://cloud.google.com/docs/authentication/gcloud) installed and authenticated
  </Step>

  <Step title="Docker Registry Authentication">
    Run `gcloud auth configure-docker europe-west2-docker.pkg.dev` to authenticate
  </Step>

  <Step title="API Keys">
    API keys for your chosen AI provider, email service, and integrations (GitHub, Linear, etc.)
  </Step>
</Steps>

## Deployment

By default, Bilanc is deployed as a Docker image using Docker Compose. We can explore other deployment options (e.g. Helm charts) if required.

## Updates

Updates are distributed via versioned Docker images. A staging environment is recommended to test updates before production.

Update cadence is flexible based on your needs.

## Cloud Provider Support

Bilanc is cloud agnostic and supports all major cloud providers (AWS, GCP, Azure).

## Recommended Configuration

| Component              | CPU | RAM   | Storage |
| ---------------------- | --- | ----- | ------- |
| API Server             | 1   | 2GB   | -       |
| Dashboard              | 1   | 2GB   | -       |
| Orchestrator Webserver | 1   | 2GB   | -       |
| Orchestrator Daemon    | 1   | 2GB   | -       |
| Celery Worker          | 1   | 2GB   | -       |
| Redis Broker           | 0.5 | 128MB | -       |
| PostgreSQL             | 2   | 8GB   | 128GB   |

## Scaling

Auto-scaling is not provided out-of-the-box yet, but the default configuration scales well for most use cases. We can guide you on configuring auto-scaling when needed.

Bottlenecks mostly depend on:

* **Data Transformation**: Solved by scaling Postgres vertically

## Data Storage

* **PostgreSQL**: Persists application state, user data, and analytics

## Using Existing Data Stores

Bilanc is flexible with data store setups. However, we recommend a separate PostgreSQL instance for independent scaling and isolation.

## Internet Access Requirements

| Service       | Requirement                                             |
| ------------- | ------------------------------------------------------- |
| API Server    | Required for pulling team information from GitHub       |
| Orchestrator  | Required for data ingestion from GitHub, Linear, Cursor |
| Email Service | Required for sending notifications via Resend           |
| AI Provider   | Required for generating AI insights                     |

<Tip>
  If you are interested in the self-hosting version, please get in touch with us at [support@bilanc.co](mailto:support@bilanc.co) or book a [demo](https://calendly.com/0x-s13i/bilanc-15-min-customer-discovery-call).
</Tip>