Single Node vs High Availability

Choose single-node (evaluation) or HA (production) topology based on uptime, failover, and scaling requirements.

After choosing your installation method, decide whether to run a single node or high availability (HA).

When To Use This Page

Use this page after choosing an installation method and before production sizing or infrastructure provisioning.

flowchart TD
    subgraph flow["Single Node vs High Availability"]
        A[Decision Maker] -->|Deployment Topology| B{Production?}
        B -->|Yes| C[High Availability<br />Recommended]
        B -->|No| D[Single Node<br />Evaluation / Dev]
    end

Comparison

Single NodeHigh Availability
Use caseEvaluation, dev, small teamsProduction, mission-critical
Nodes12+ (3+ recommended)
DatabaseBundled or externalExternal PostgreSQL required
StorageLocal PVCShared object storage (S3, GCS, Azure Blob)
FailoverNone — manual recoveryAutomatic
Downtime for maintenanceYesNo — rolling updates
Horizontal scalingNoYes

HA Requirements

To run High Availability, you need:

  • External database — Managed PostgreSQL (AWS RDS, Azure Database for PostgreSQL, or Google Cloud SQL)
  • Shared object storage — S3, GCS, or Azure Blob so all nodes share binaries
  • Load balancer — Ingress (Kubernetes) or Route (OpenShift) with health checks
  • Multiple replicasartifactory.artifactory.replicaCount of 2+ (3+ recommended)
  • Shared keys — Master Key and Join Key in Kubernetes Secrets
flowchart TD
    subgraph arch["High Availability Architecture"]
        LB[Load Balancer]
        LB --> N1[Node 1]
        LB --> N2[Node 2]
        LB --> N3[Node 3]
        N1 & N2 & N3 --> PG[(PostgreSQL)]
        N1 & N2 & N3 --> OS[Object Storage]
    end
📘

Migration Path

You can start with a single-node deployment and migrate to HA later by adding an external database, shared storage, and additional replicas. See High Availability Planning.

Practical Decision Thresholds

Use these thresholds as a quick decision aid:

SignalStart with Single NodeStart with HA
Availability targetNon-critical workloadsStrict uptime/SLA targets
Team size / usageSmall team, low concurrencyMultiple teams, sustained parallel CI/CD usage
Operational modelEvaluation or short-lived environmentsLong-lived production with planned maintenance windows
Recovery toleranceManual recovery acceptableAutomatic failover required

Related Topics