Skip to content
Self-hosting

Run chat, dashboards, SSO, SCIM, and audit logs on Docker Compose or Kubernetes in your own cloud or data center. Your databases are queried from inside your network, and AI runs on the provider and keys you choose.

Net revenue retention by segment

Self-hosted

What was net revenue retention by segment last quarter?

Q3 net revenue retention was 112% overall. Enterprise led at 121%, while SMB dipped below 100% for the first time this year.

3 rows · 412 ms
Enterprise121%
Mid-market108%
SMB94%

Dashed line: 100% retention

Ask a follow-up

Powering analytics for 5000+ teams worldwide

Exa logoTiger Data logoPurpose logoGumloop logoComposio logoFullscript logoShiftrx logoDrata logoExa logoTiger Data logoPurpose logoGumloop logoComposio logoFullscript logoShiftrx logoDrata logo

Deployment

Install with Docker Compose and the Distr agent, plain Compose, or a Helm chart on Kubernetes 1.28 and up. AWS, Azure, Google Cloud, DigitalOcean, or your own data center all work, and PostgreSQL is the only service it depends on.

Terminal

$ curl "https://<hub>/api/v1/connect?targetId=<id>&targetSecret=<secret>" \
    | docker compose -f - up -d
 ✔ Container distr-agent-1    Started

# Pick a version in the Distr portal to deploy

Deployment

Healthy
Release
2026.09.30
Method
Docker Compose · Distr agent
Database
Bundled PostgreSQL

Your AI provider

Point Basedash at OpenAI, Anthropic, Azure OpenAI, Amazon Bedrock, xAI, OpenRouter, or an internal OpenAI-compatible gateway. Your keys and your provider agreement apply, and Bedrock can authenticate with an IAM role instead of a key.

AI provider

.env

Amazon Bedrock

AI_MODEL=amazon-bedrock/anthropic.claude-sonnet-5AI_BEDROCK_REGION=us-east-1# No keys set: uses your IAM role

Restricted networks

Basedash, its PostgreSQL database, and your data sources stay inside your network. Without the Distr agent, the only required outbound calls are image pulls and a license check to charts.basedash.com every six hours.

Upgrades

Basedash never updates your deployment on its own. Each calendar-versioned release ships with notes that flag one-way migrations, so you can back up, test in staging, and roll forward from the Distr portal or with one command.

Versions

Release notes

2026.09.30

  • GPT-6.1 Sol is the default OpenAI model
  • Azure OpenAI backs every AI feature
  • Chart images render CJK, Arabic, and emoji
  • Security fixes, upgrade recommended

Back up the database first

Basedash sizes the deployment with you, then you run it like any other internal service.

  1. Plan the rollout

    Start with an infrastructure review. Together you pick a size and a deployment method for the number of people who'll use it.

  2. Deploy from the portal

    In the Distr customer portal, create the four required secrets, set your base URL, and start the containers.

  3. Connect and configure

    Check the health endpoint, add your AI key, email, and SSO, then connect your databases and warehouses directly.

What's included

Self-hosting is part of the Enterprise plan, available to select customers, with the same product and the same team behind it as the cloud.

  • Enterprise plan

    For select customers, with unbilled sandbox licenses for QA.

  • The same product

    Chat, dashboards, SSO, SCIM, permissions, and audit logs.

  • Any infrastructure

    Any cloud, region, or data center with Docker or Kubernetes.

  • One dependency

    PostgreSQL, bundled with the app or managed by you.

  • Your encryption keys

    You generate the keys that encrypt credentials and fields.

  • Direct connections

    Databases and warehouses are queried in place, over your network.

  • Sized up to 10,000 users

    Reference sizes from one server to a Kubernetes cluster.

  • Release notes and support

    Notes on every version, and a team that helps you plan.

Where it runs, what it needs, and how upgrades, AI providers, and licensing work.

Where can self-hosted Basedash run?

Anywhere you can run Docker or Kubernetes: AWS, Azure, Google Cloud, DigitalOcean, an on-premises data center, or a hybrid setup, in any region. Smaller teams run Docker Compose on a single server, with or without the Distr agent, which Basedash recommends up to about 500 users. Larger rollouts use the Helm chart on Kubernetes 1.28 or later, with an ingress controller and a managed PostgreSQL database, so the app can scale across replicas.

What infrastructure does a self-hosted deployment need?

Up to 100 users, one server with 2 vCPUs, 8 GB of memory, and a 50 GB SSD runs Basedash on Docker Compose; up to 500 users, 4 vCPUs, 16 GB, and 100 GB. Beyond that, plan on Kubernetes with about one app replica per 500 users at 2 vCPUs and 4 GiB each, plus managed PostgreSQL 16 or later. PostgreSQL is the only required dependency. Avoid burstable instance types, and talk to Basedash about anything above 10,000 users.

How do upgrades work for self-hosted Basedash?

Nothing updates automatically. Releases use calendar versions, such as 2026.09.30, and each is published for Docker Compose and Helm with release notes in the Distr portal. With the Distr agent, you pick the new version in the portal; with plain Compose, you pull and restart; with Helm, you change the image tag and run helm upgrade. Migrations run on startup, so back up first, check the notes for migrations that can't be rolled back, and test in staging if you need strict change control.

Which AI model providers can a self-hosted deployment use?

OpenAI, Anthropic, Azure OpenAI, Amazon Bedrock, xAI, and OpenRouter, plus any OpenAI-compatible endpoint such as an internal LLM gateway. You set your own keys and choose the main and fast models with two environment variables, and Bedrock can use an IAM role instead of access keys. The app starts without an AI key, but chat, chart generation, and insights need one. Basedash tests against its default models, so others may produce lower-quality SQL and charts.

Can Basedash run in an air-gapped network?

Not completely on its own. A self-hosted deployment validates its license with an HTTPS call to charts.basedash.com at startup and every six hours, and it won't start if that first check fails. Container images also come from registry.distr.sh. Everything else can stay internal: AI can run through Bedrock or your own gateway, and email, object storage, and data sources can all be internal services. If your network allows no outbound traffic at all, contact Basedash before you deploy.

What does Basedash receive from a self-hosted deployment?

Only what licensing needs. Every six hours the server sends a heartbeat with the app version and its organization and user counts, which Basedash uses for billing. Your data, queries, dashboards, and chats stay in your deployment and its PostgreSQL database, and prompts go only to the AI provider you configure. If a heartbeat fails, existing users keep working while the server retries, and a banner appears until it reconnects.

How is self-hosting licensed and supported?

Self-hosting is part of the Enterprise plan and currently available to select customers. It starts with an email to [email protected], followed by an infrastructure review and sizing. You then get a license key and access to the Distr customer portal, which holds the container images, Compose files, Helm chart, and release notes for every version. Basedash supports the deployment after launch, and sandbox licenses for QA and CI environments aren't billed. It includes the same access controls as the cloud, from SSO and SCIM to audit logs. See Enterprise for the rest of the plan.

Try the product in the cloud today, then plan your self-hosted rollout with us.