FerrisKey on Kubernetes

FerrisKey is designed to run natively on Kubernetes. Choose between two deployment methods depending on your operational needs.

Helm Chart

Install FerrisKey with a standard Helm chart. Full control over values, familiar workflow.

Operator

Declarative management with the FerrisKey Operator and the FerrisKeyCluster CRD.

Architecture on Kubernetes

graph TD
    ING[Ingress / Load Balancer]
    API[FerrisKey API Pods]
    WEB[FerrisKey Web UI Pods]
    MIG[Migration Job]
    PG[(PostgreSQL)]

    ING --> API
    ING --> WEB
    API --> PG
    MIG --> PG

A typical FerrisKey deployment consists of:

API pods — The FerrisKey backend handling authentication, token issuance, and administration
Web UI pods — The React-based admin console
Migration job — Runs database migrations on deploy
PostgreSQL — The backing database (managed or self-hosted)

Next Steps

Helm Chart

Step-by-step Helm installation guide.

Production Guide

Hardening checklist for production deployments.