Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

4.5 KB
Raw Blame
---
title: "Self-hosting Infisical"
description: "Run Infisical on your own infrastructure, from a single container to a high availability cluster."
sidebarTitle: "Self-hosting"
icon: "server"
---

You can self-host Infisical instead of using Infisical Cloud. This keeps your data on your own infrastructure and network.

<Accordion title="Why self-host?">
  Teams usually choose self-hosting for two reasons:

  - **Compliance.** Running Infisical inside your own environment lets it sit behind your existing security controls, which matters for SOC 2, HIPAA, and FIPS 140-3. All data stays under your governance.
  - **Flexibility.** You control the deployment topology. Infisical runs on air-gapped bare metal, Kubernetes clusters, and cloud VMs alike, so you can tune networking, security, and performance to fit.
</Accordion>

Before you begin, check the [hardware requirements](/self-hosting/configuration/requirements) for your expected load. If you need Enterprise features such as SSO or gateways, see [Enterprise licensing](/self-hosting/ee).

## Get started

Pick the platform you already run:

<CardGroup cols={3}>
  <Card title="Docker" icon="docker" iconType="brands" href="/self-hosting/deployment-options/standalone-infisical">
    A single packaged container. The quickest way to get an instance running.
  </Card>
  <Card title="Docker Compose" icon="docker" iconType="brands" href="/self-hosting/deployment-options/docker-compose">
    Infisical, PostgreSQL, and Redis together from one template.
  </Card>
  <Card title="Kubernetes" icon="settings" href="/self-hosting/deployment-options/kubernetes-helm">
    Deploy with the official Helm chart, with bundled PostgreSQL and Redis.
  </Card>
  <Card title="Linux package" icon="linux" iconType="brands" href="/self-hosting/deployment-options/native/linux-package/installation">
    Install directly on a host, with no containers involved.
  </Card>
  <Card title="AWS" icon="aws" iconType="brands" href="/self-hosting/deployment-options/aws-native">
    ECS with Fargate, backed by RDS, ElastiCache, and an ALB.
  </Card>
  <Card title="GCP" icon="google" iconType="brands" href="/self-hosting/deployment-options/gcp-native">
    GKE, backed by Cloud SQL and Memorystore.
  </Card>
</CardGroup>

## Configure

Apply settings once the instance is running:

<CardGroup cols={3}>
  <Card title="Environment variables" icon="list" href="/self-hosting/configuration/envars">
    Every variable the instance reads, and which ones are required.
  </Card>
  <Card title="Custom certificates" icon="award" href="/self-hosting/guides/custom-certificates">
    Trust an internal certificate authority or use your own TLS certificates.
  </Card>
  <Card title="HSM integration" icon="cpu" href="/self-hosting/guides/hsm-integration">
    Back the encryption root key with a hardware security module.
  </Card>
  <Card title="Programmatic provisioning" icon="terminal" href="/self-hosting/guides/automated-bootstrapping">
    Set up an instance from scratch without touching the UI.
  </Card>
  <Card title="CDN caching" icon="bolt" href="/self-hosting/guides/cdn-caching">
    Serve static assets from a CDN to cut load times.
  </Card>
</CardGroup>

## Operate

Keep the instance healthy once it's carrying real traffic:

<CardGroup cols={3}>
  <Card title="Server admin console" icon="sliders-horizontal" href="/documentation/platform/admin-panel/server-admin">
    Instance-wide settings, user management, and sign-up controls.
  </Card>
  <Card title="Upgrade Infisical" icon="arrow-up" href="/self-hosting/guides/upgrading-infisical">
    Move to a newer version without losing data.
  </Card>
  <Card title="Multi-region replication" icon="globe" href="/self-hosting/guides/replication">
    Run read replicas closer to the teams that use them.
  </Card>
  <Card title="Production hardening" icon="shield-half" href="/self-hosting/guides/production-hardening">
    What to lock down before you put an instance in front of a team.
  </Card>
  <Card title="Monitoring and telemetry" icon="chart-line" href="/self-hosting/guides/monitoring-telemetry">
    Collect metrics and traces with Grafana and OpenTelemetry.
  </Card>
  <Card title="Migrate Mongo to PostgreSQL" icon="database" href="/self-hosting/guides/mongo-to-postgres">
    Move an instance from the older MongoDB backend.
  </Card>
</CardGroup>

## Common questions

Answers to the questions that come up most often when running your own instance, including licensing, upgrades, and backups.

<Card title="Self-hosting FAQ" icon="circle-question-mark" href="/self-hosting/faq">
  Read the FAQ.
</Card>