Skip to content

Requirements

OpenSearch 3.x, Java 17, 4GB RAM.


Requirements (Search) · v0.4

Runtime

  • OpenSearch: 2.x (target 3.x), JVM 17
  • Plugins: analysis-icu, ingest-attachment (optional)
  • Heap: 50% of RAM up to 32 GB (do not exceed), e.g., -Xms8g -Xmx8g
  • FS: SSD/NVMe, noatime

System

  • Swappiness 1, overcommit disabled for data nodes
  • Transparent huge pages disabled
  • vm.max_map_count ≥ 262144

Network

  • Dedicated network for data nodes if possible; keep client/API connections separate
  • TLS for transport and HTTP (self-signed OK internally)

Env Vars (examples)

Var Example Purpose
OS_URL http://localhost:9200 Cluster endpoint
OS_USER admin Basic auth user
OS_PASS ... Password

See: IaC for provisioning scripts.