Skip to content

Artifactory Pro High Availability (HA) Setup

info

Multi-node clusters provide redundancy, zero-downtime upgrades, and higher performance for larger teams and 24/7 environments.

HA Architecture Diagram

flowchart TD
  NGINX[NGINX LB/Reverse Proxy] --> Node1[Artifactory Pro Node 1]
  NGINX --> Node2[Artifactory Pro Node 2]
  NGINX --> NodeN[Artifactory Pro Node N]
  Node1 -.-> DB[(External Database: PostgreSQL, etc.)]
  Node2 -.-> DB
  NodeN -.-> DB
  Node1 -.-> NFS[(Shared Filestore: NFS/S3/Blob Storage)]
  Node2 -.-> NFS
  NodeN -.-> NFS
  NFS --> Backup[Backup System]
  DB --> Backup

Requirements

  • Minimum 2 (recommended 3+) Artifactory Pro nodes (each with license!)
  • All nodes connect to the same external database back-end
  • All nodes share a single storage/filestore (NFS, S3, Google/Azure Blob, etc.)
  • High-speed, reliable interconnect (private VPC, VLAN)
  • Shared cluster key configured in each node's system.yaml (shared: joinKey:)
  • NGINX or similar load balancer with sticky sessions

Warning

Ensure ALL nodes use exactly the same JVM options, configuration, and Artifactory version. Always perform rolling upgrades.

See advanced-config.md for lifecycle, backup, security, and advanced scaling tips.