Skip to Content
Install & DeployOverview

Deployment

Classifyre ships in two distributions, with the same features in both:

  • Desktop — one installer for macOS, Windows, or Linux, with the database and scan workers inside the package.
  • Kubernetes with Helm — for shared instances, production, high availability, and horizontal scaling.

A namespace export moves work from one to the other, so this is not a decision you are locked into.

Option 01 · Desktop

Install it on your machine

One installer for macOS, Windows, or Linux. PostgreSQL and the scan workers are inside the package, so there is nothing to provision — and only the desktop build can scan a local folder.

Download Classifyre

macOS · Windows · Linux — free, no signup

All builds on GitHub →
Desktop install guide →

Option 02 · Kubernetes

Or run it on a cluster

Helm, OCI-native · no repo add

The chart deploys the web UI, API, worker, and the ephemeral scan Jobs. PostgreSQL can be embedded for a trial or external for production.

helm install classifyre \
  oci://registry-1.docker.io/classifyre/classifyre-core \
  --namespace classifyre --create-namespace \
  --version 0.4.132
Kubernetes deployment guide →

Desktop

The desktop package carries the API, the web UI, the Python scan workers, and an embedded PostgreSQL, so nothing else has to be installed. It is also the only build that can scan a local folder.

Read the desktop install guide.

Kubernetes

The official Helm chart deploys the web UI, API, background worker, ephemeral CLI scan Jobs, and the required Kubernetes services and RBAC. PostgreSQL may be provided by the chart for development or connected as external infrastructure for production. Object storage is optional.

Read the Kubernetes deployment guide.

Platform components

The supported deployments use the same application components:

  • Web UI: the user-facing Next.js application.
  • API and worker: orchestration, state, background queues, and automation.
  • CLI Jobs: isolated source extraction and detection runs.
  • PostgreSQL: application state and investigation data.
  • Object storage: optional logs and uploaded artifacts.
Last updated on