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.

Quickstart

Get up and running in 5 minutes

Configuration

Environment variables and tenant setup

Integrations

Connect GitHub, Linear, and Cursor

Infrastructure

Architecture and components

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:

1. Docker & Docker Compose

   Docker and Docker Compose v2+ installed on your system

2. Registry Access

   Access to the Bilanc self-hosted Docker image (contact a Bilanc team member)

3. Google Cloud CLI

   gcloud CLI installed and authenticated

4. Docker Registry Authentication

   Run gcloud auth configure-docker europe-west2-docker.pkg.dev to authenticate

5. API Keys

   API keys for your chosen AI provider, email service, and integrations (GitHub, Linear, etc.)

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

If you are interested in the self-hosting version, please get in touch with us at [e-mail] or book a demo.