Docs
  • Release notes
  • Troubleshoot
  • Reference
  • Get started
  • Solutions and use cases
  • Manage data
  • Explore and analyze
  • Manage your Cloud account and preferences
  • Troubleshoot
  • Release notes
  • Reference
  • Extend and contribute
  • Deploy
    • Detailed deployment comparison
    • Elastic Cloud
      • Compare Cloud Hosted and Serverless
      • Sign up
        • Subscribe from a marketplace
          • AWS Marketplace
          • Azure Native ISV Service
          • Google Cloud Platform Marketplace
          • Heroku
            • Install the add-on
              • Remove the add-on
            • Access the console
            • Work with Elasticsearch
            • Migrate between plans
            • Hardware
            • Regions
      • Elastic Cloud Serverless
        • Create a serverless project
        • Regions
        • Project settings
      • Elastic Cloud Hosted
        • Create an Elastic Cloud Hosted deployment
          • Available stack versions
        • Access Kibana
        • Manage deployments
          • Configure
            • Change hardware profiles
            • Customize deployment components
            • Edit Elastic Stack settings
            • Add plugins and extensions
              • Upload custom plugins and bundles
              • Manage plugins and extensions through the API
            • Custom endpoint aliases
          • Manage your Integrations server
            • Switch from APM to Integrations Server payload
          • Find your Cloud ID
        • vCPU boosting and credits
        • Change hardware
        • Manage deployments using the Elastic Cloud API
        • Keep track of deployment activity
        • Restrictions and known problems
      • Tools and APIs
    • Elastic Cloud Enterprise
      • Service-oriented architecture
      • Deploy an orchestrator
        • Prepare your environment
          • Hardware prerequisites
          • Software prerequisites
          • System configuration
          • Networking prerequisites
          • Users and permissions prerequisites
          • High availability
          • Separation of roles
          • Load balancers
          • JVM heap size
          • Wildcard DNS record
          • Manage your allocators capacity
        • Install ECE
          • Identify the deployment scenario
          • Configure your operating system
            • Ubuntu
            • RHEL
            • SUSE
          • Installation procedures
            • Deploy a small installation
            • Deploy a medium installation
            • Deploy a large installation
            • Deploy using Podman
            • Migrate ECE to Podman hosts
              • Migrating to Podman 5
          • Post-installation steps
          • Install ECE on additional hosts
            • Manage roles tokens
          • Ansible playbook
          • Statistics collected by Elastic Cloud Enterprise
        • Air-gapped install
          • With your private Docker registry
          • Without a private Docker registry
          • Available Docker images
        • Configure ECE
          • Assign roles to hosts
          • System deployments configuration
            • Default system deployment versions
          • Manage deployment templates
            • Tag your allocators
            • Edit instance configurations
            • Create instance configurations
            • Create templates
            • Configure default templates
            • Configure index management
            • Data tiers and autoscaling support
            • Integrations server support
            • Default instance configurations
          • Change the ECE API URL
          • Change endpoint URLs
          • Enable custom endpoint aliases
          • Configure allocator affinity
          • Change allocator disconnect timeout
          • Manage Elastic Stack versions
          • Include additional Kibana plugins
      • Log into the Cloud UI
      • Manage deployments
        • Deployment templates
        • Create a deployment
        • Access Kibana
        • Connect to Elasticsearch
        • Configure
          • Customize deployment components
          • Edit stack settings
            • Elasticsearch user settings
            • Kibana user settings
            • APM user settings
            • Enterprise search user settings
          • Resize deployment
          • Configure plugins and extensions
          • Add custom bundles and plugins
          • Custom endpoint aliases
          • Resource overrides
          • Advanced cluster configuration
        • Search and filter deployments
        • Keep track of deployment activity
        • Manage your Integrations Server
          • Enable Integrations Server through the API
          • Switch from APM to Integrations Server payload
      • Tools and APIs
    • Elastic Cloud on Kubernetes
      • Deploy an orchestrator
        • Install
          • YAML manifests
          • Helm chart
          • Required RBAC permissions
          • Deploy ECK on Openshift
            • Deploy the operator
            • Deploy an Elasticsearch instance with a route
            • Deploy a Kibana instance with a route
            • Deploy Docker images with anyuid SCC
            • Grant privileged permissions to Beats
            • Grant host access permission to Elastic Agent
          • Deploy ECK on GKE Autopilot
          • FIPS compatibility
        • Air-gapped environments
        • Configure
          • Apply configuration settings
          • Configure the validating webhook
          • Restrict cross-namespace resource associations
          • Service meshes
            • Istio
            • Linkerd
          • Webhook namespace selectors
      • Manage deployments
        • Deploy an Elasticsearch cluster
        • Deploy a Kibana instance
        • Elastic Stack Helm chart
        • Applying updates
        • Accessing services
        • Configure deployments
          • Elasticsearch configuration
            • Nodes orchestration
            • Storage recommendations
            • Node configuration
            • Volume claim templates
            • Virtual memory
            • Settings managed by ECK
            • Custom configuration files and plugins
            • Init containers for plugin downloads
            • Update strategy
            • Pod disruption budget
            • Advanced Elasticsearch node scheduling
            • Readiness probe
            • Pod PreStop hook
            • Security context
            • Requests routing to Elasticsearch nodes
          • Kibana configuration
            • Connect to an Elasticsearch cluster
            • Advanced configuration
            • Install Kibana plugins
          • Customize pods
          • Manage compute resources
          • Recipes
          • Connect to external Elastic resources
          • Elastic Stack configuration policies
      • Orchestrate other Elastic applications
        • APM server
          • Use an Elasticsearch cluster managed by ECK
          • Advanced configuration
          • Connect to the APM Server
        • Standalone Elastic Agent
          • Quickstart
          • Configuration
          • Configuration examples
        • Fleet-managed Elastic Agent
          • Quickstart
          • Configuration
          • Configuration Examples
          • Known limitations
        • Elastic Maps Server
          • Deploy Elastic Maps Server
          • Map data
          • Advanced configuration
          • Elastic Maps HTTP configuration
        • Beats
          • Quickstart
          • Configuration
          • Configuration Examples
          • Troubleshooting
        • Logstash
          • Quickstart
          • Configuration
          • Securing Logstash API
          • Logstash plugins
          • Configuration examples
          • Update Strategy
          • Advanced configuration
      • Create custom images
      • Tools and APIs
    • Self-managed cluster
      • Deploy an Elasticsearch cluster
        • Local installation (quickstart)
        • Important system configuration
          • Configure system settings
          • Disable swapping
          • Increase the file descriptor limit
          • Increase virtual memory
          • Increase max number of threads
          • DNS cache settings
          • Ensure JNA temporary directory permits executables
          • Decrease the TCP retransmission timeout
          • Bootstrap checks
        • Install on Linux or MacOS
        • Install on Windows
        • Install with Debian package
        • Install with RPM package
        • Install with Docker
          • Single-node cluster
          • Multi-node cluster
          • Production settings
          • Configure
      • Configure Elasticsearch
        • Important settings configuration
        • Add plugins
      • Install Kibana
        • Linux and MacOS
        • Windows
        • Debian
        • RPM
        • Docker
      • Configure Kibana
      • Access Kibana
      • Air gapped install
      • Tools and APIs
  • Distributed architecture
    • Clusters, nodes, and shards
      • Node roles
    • Reading and writing documents
    • Shard allocation, relocation, and recovery
      • Shard allocation awareness
      • Index-level shard allocation
        • Delaying allocation when a node leaves
    • The shard request cache
    • Discovery and cluster formation
      • Discovery
      • Quorum-based decision making
      • Voting configurations
      • Bootstrapping a cluster
      • Cluster state
      • Cluster fault detection
    • Kibana task management
  • Production guidance
    • Run Elasticsearch in production
      • Design for resilience
        • Resilience in small clusters
        • Resilience in larger clusters
        • Resilience in ECH and ECE
      • Scaling considerations
      • Performance optimizations
        • General recommendations
        • Tune for indexing speed
        • Tune for search speed
        • Tune approximate kNN search
        • Tune for disk usage
        • Size your shards
    • Run Kibana in production
      • High availability and load balancing
      • Configure memory
      • Manage background tasks
      • Optimize alerting performance
      • Reporting production considerations
  • Reference architectures
    • Hot/Frozen - High Availability
  • Stack settings
  • Backup, high availability, and resilience tools
    • Snapshot and restore
      • Manage snapshot repositories
        • Self-managed
          • Azure repository
          • Google Cloud Storage repository
          • S3 repository
          • Shared file system repository
          • Read-only URL repository
          • Source-only repository
        • Elastic Cloud Hosted
          • Configure a snapshot repository using AWS S3
          • Configure a snapshot repository using GCS
          • Configure a snapshot repository using Azure Blob storage
          • Access isolation for the found-snapshots repository
            • Repository isolation on Azure
            • Repository isolation on AWS and GCP
        • Elastic Cloud Enterprise
          • AWS S3 repository
          • Google Cloud Storage (GCS) repository
          • Azure Storage repository
          • Minio on-premise repository
        • Elastic Cloud on Kubernetes
      • Create snapshots
      • Restore a snapshot
        • Restore a snapshot across clusters
          • Restore snapshot into a new deployment
          • Restore snapshot into an existing deployment
          • Restore snapshots containing searchable snapshots indices across clusters
      • Searchable snapshots
    • Cross-cluster replication
      • Set up cross-cluster replication
        • Prerequisites
        • Connect to a remote cluster
        • Configure privileges for cross-cluster replication
        • Create a follower index to replicate a specific index
        • Create an auto-follow pattern to replicate time series indices
      • Manage cross-cluster replication
        • Inspect replication statistics
        • Pause and resume replication
        • Recreate a follower index
        • Terminate replication
      • Manage auto-follow patterns
        • Create auto-follow patterns
        • Retrieve auto-follow patterns
        • Pause and resume auto-follow patterns
        • Delete auto-follow patterns
      • Upgrading clusters
        • Uni-directional index following
        • Bi-directional index following
      • Uni-directional disaster recovery
        • Prerequisites
        • Failover when clusterA is down
        • Failback when clusterA comes back
      • Bi-directional disaster recovery
        • Initial setup
        • Failover when clusterA is down
        • Failback when clusterA comes back
        • Perform update or delete by query
  • Autoscaling
    • In ECE and ECH
    • In ECK
    • Autoscaling deciders
    • Trained model autoscaling
  • Security
    • Secure your orchestrator
      • Elastic Cloud Enterprise
        • Manage security certificates
        • Allow x509 Certificates Signed with SHA-1
        • Configure the TLS version
        • Migrate ECE on Podman hosts to SELinux enforce
      • Elastic Cloud on Kubernetes
    • Secure your cluster or deployment
      • Self-managed security setup
        • Automatic security setup
        • Minimal security setup
        • Set up transport TLS
        • Set up HTTPS
        • Configure security in Kibana
      • Manage TLS encryption
        • Self-managed
          • Update TLS certificates
            • With the same CA
            • With a different CA
          • Mutual authentication
          • Supported SSL/TLS versions by JDK version
          • Enabling cipher suites for stronger encryption
        • ECK
          • Manage HTTP certificates on ECK
          • Manage transport certificates on ECK
      • Traffic filtering
        • IP traffic filtering
          • In ECH or ECE
            • Manage traffic filters through the API
          • In ECK and Self Managed
        • Private link traffic filters
          • AWS PrivateLink traffic filters
          • Azure Private Link traffic filters
          • GCP Private Service Connect traffic filters
          • Claim traffic filter link ID ownership through the API
        • Kubernetes network policies
      • Elastic Cloud Static IPs
      • Kibana session management
      • Encrypt your deployment data
        • Use a customer-managed encryption key
      • Secure your settings
        • Secure settings on ECK
      • Secure Kibana saved objects
      • Security event audit logging
        • Enable audit logging
        • Configure audit logging
          • Elasticsearch audit events ignore policies
          • Elasticsearch logfile output
        • Audit Elasticsearch search queries
        • Correlate audit events
      • FIPS 140-2 compliance
    • Secure other Elastic Stack components
    • Securing HTTP client applications
    • Limitations
  • Users and roles
    • Cloud organization
      • Manage users
      • User roles and privileges
      • Configure SAML SSO
        • Okta
        • Microsoft Entra ID
    • ECE orchestrator
      • Manage system passwords
      • Manage users and roles
        • Native users
        • Active Directory
        • LDAP
        • SAML
      • Configure SSO for deployments
    • Serverless project custom roles
    • Cluster or deployment
      • Quickstart
      • User authentication
        • Authentication realms
          • Realm chains
          • Security domains
        • Internal authentication
          • Native
          • File-based
        • External authentication
          • Active Directory
          • JWT
          • Kerberos
          • LDAP
          • OpenID Connect
            • With Azure, Google, or Okta
          • SAML
            • With Microsoft Entra ID
          • PKI
          • Custom realms
        • Built-in users
          • Change passwords
        • Orchestrator-managed users
          • ECH and ECE
          • ECK managed credentials
        • Kibana authentication
        • Kibana access agreement
        • Anonymous access
        • Token-based authentication services
        • Service accounts
        • Internal users
        • Operator privileges
          • Configure operator privileges
          • Operator-only functionality
          • Operator privileges for snapshot and restore
        • User profiles
        • Looking up users without authentication
        • Controlling the user cache
        • Manage authentication for multiple clusters
      • User roles
        • Built-in roles
        • Defining roles
          • Role structure
          • For data streams and aliases
          • Using Kibana
          • Role restriction
        • Elasticsearch privileges
        • Kibana privileges
        • Map users and groups to roles
          • Role mapping properties
        • Authorization delegation
        • Authorization plugins
        • Control access at the document and field level
        • Submit requests on behalf of other users
  • Spaces
  • API keys
    • Elasticsearch API keys
    • Serverless project API keys
    • Elastic Cloud API keys
    • Elastic Cloud Enterprise API keys
  • Connectors
  • Remote clusters
    • Elastic Cloud Hosted
      • Within the same Elastic Cloud organization
      • With a different Elastic Cloud organization
      • With Elastic Cloud Enterprise
      • With a self-managed cluster
      • With Elastic Cloud on Kubernetes
      • Edit or remove a trusted environment
      • Migrate the CCS deployment template
    • Elastic Cloud Enterprise
      • Within the same ECE environment
      • With a different ECE environment
      • With Elastic Cloud
      • With a self-managed cluster
      • With Elastic Cloud on Kubernetes
      • Edit or remove a trusted environment
      • Migrate the CCS deployment template
    • Self-managed Elastic Stack
      • Add remote clusters using API key authentication
      • Add remote clusters using TLS certificate authentication
      • Migrate from certificate to API key authentication
      • Remote cluster settings
    • Elastic Cloud on Kubernetes
  • Monitoring
    • AutoOps
      • How to access AutoOps
      • AutoOps events
      • Views
        • Overview
        • Deployment
        • Nodes
        • Indices
        • Shards
        • Template Optimizer
      • Notifications Settings
      • Event Settings
      • Dismiss Events
      • AutoOps regions
      • AutoOps FAQ
    • Stack monitoring
      • Enable on ECH and ECE
      • Enable on ECK
      • Self-managed: Elasticsearch
        • Collecting monitoring data with Elastic Agent
        • Collecting monitoring data with Metricbeat
        • Collecting log data with Filebeat
        • Monitoring in a production environment
        • Legacy collection methods
          • Collectors
          • Exporters
          • Local exporters
          • HTTP exporters
          • Pausing data collection
      • Self-managed: Kibana
        • Collect monitoring data with Elastic Agent
        • Collect monitoring data with Metricbeat
        • Legacy collection methods
      • Access monitoring data in Kibana
      • Visualizing monitoring data
        • Beats metrics
        • Elasticsearch metrics
        • Kibana metrics
        • Logstash metrics
        • Troubleshooting
      • Stack monitoring alerts
      • Configuring monitoring data streams and indices
        • Configuring data streams created by Elastic Agent
        • Configuring data streams created by Metricbeat 8
        • Configuring indices created by Metricbeat 7 or internal collection
    • Cloud deployment health
      • Performance metrics on Elastic Cloud
      • JVM memory pressure indicator
    • Kibana task manager monitoring
    • Monitoring orchestrators
      • ECK operator metrics
        • Enabling the metrics endpoint
        • Securing the metrics endpoint
        • Prometheus requirements
      • ECE platform monitoring
        • Platform monitoring deployment logs and metrics
        • Proxy log fields
        • Set the retention period for logging and metrics indices
    • Logging
      • Elasticsearch log4j configuration
      • Update Elasticsearch logging levels
      • Elasticsearch deprecation logs
      • Kibana logging
        • Set global log levels for Kibana
        • Advanced Kibana logging settings
          • Examples
  • Configure Kibana reporting
  • Manage your Cloud organization
    • Billing
      • Hosted billing dimensions
      • Serverless billing dimensions
        • Elasticsearch
        • Elastic for Observability
        • Elastic for Security
      • Billing models
      • Add your billing details
      • View your billing history
      • Manage your subscription
      • Monitor and analyze usage
      • Elastic Consumption Units
      • Billing FAQ
    • Operational emails
    • Update billing and operational contacts
    • Service status
    • Tools and APIs
  • Licenses and subscriptions
    • Elastic Cloud Enterprise
    • Elastic Cloud on Kubernetes
    • Self-managed cluster
  • Maintenance
    • ECE maintenance
      • Deployments maintenance
        • Pause instance
      • Maintenance activities
        • Enable maintenance mode
        • Scale out your installation
        • Move nodes or instances from allocators
        • Perform ECE hosts maintenance
        • Delete ECE hosts
    • Start and stop services
      • Start and stop Elasticsearch
      • Start and stop Kibana
      • Restart an Elastic Cloud Hosted deployment
      • Restart an ECE deployment
      • Full Cluster restart and rolling restart procedures
    • Start and stop routing requests
    • Add and Remove Elasticsearch nodes
  • Upgrade
    • Plan your upgrade
    • Upgrade your ECE or ECK orchestrator
      • Upgrade Elastic Cloud Enterprise
        • Re-running the ECE upgrade
      • Upgrade Elastic Cloud on Kubernetes
    • Prepare to upgrade
      • Upgrade Assistant
    • Upgrade your deployment or cluster
      • Upgrade on Elastic Cloud Hosted
      • Upgrade on Elastic Cloud Enterprise
      • Upgrade on Elastic Cloud on Kubernetes
      • Upgrade Elastic on a self-managed cluster
        • Upgrade Elasticsearch
          • Archived settings
          • Reading indices from older Elasticsearch versions
        • Upgrade Kibana
          • Saved object migrations
          • Roll back to a previous version
      • Upgrade to Enterprise Search
    • Upgrade your ingest components
  • Uninstall
    • Uninstall Elastic Cloud Enterprise
    • Uninstall Elastic Cloud on Kubernetes
    • Delete an orchestrated deployment
Loading
  1. Docs
  2. / Elastic Docs
  3. / …
  4. / Deploy an orchestrator
  5. / Install ECE
  6. /

Configure your operating system

ECE

Before installing Elastic Cloud Enterprise, you have to prepare your hosts with one of the following Linux distributions:

  • Ubuntu 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish)
  • Red Hat Enterprise Linux (RHEL) 8 and 9
  • Rocky Linux 8 and 9
  • SUSE Linux Enterprise Server (SLES) 12 SP5 and 15
Previous
Identify the deployment scenario
Next
Ubuntu
  • Current version ✓
  • Previous version
  • Edit this page
  • Report an issue
Elastic logo
  • Trademarks
  • Terms of Use
  • Privacy
  • Sitemap

© 2025 Elasticsearch B.V. All Rights Reserved.

Elasticsearch is a trademark of Elasticsearch B.V., registered in the U.S. and in other countries. Apache, Apache Lucene, Apache Hadoop, Hadoop, HDFS and the yellow elephant logo are trademarks of the Apache Software Foundation in the United States and/or other countries.

Welcome to the docs for the latest Elastic product versions, including Elastic Stack 9.0 and Elastic Cloud Serverless. To view previous versions, go to elastic.co/guide.