Version: SG FLX
Installation and Setup
This section covers everything needed to install and configure Search Guard in your Elasticsearch environment, from initial installation through TLS setup and version management.
What’s in This Section
- Installation - Step-by-step installation of Search Guard plugins
- TLS Certificate Setup - Configure transport and REST layer encryption
- Versions and Compatibility - Find compatible versions and check EOL status
- Upgrades and Migrations - Upgrade between versions or migrate from classic to FLX
Installation Workflow
1. Install Search Guard Plugins
Start with Installation to install the Search Guard Elasticsearch and Kibana plugins. This guide covers plugin installation for all supported versions.
2. Set Up TLS Encryption
TLS is required for Search Guard. The TLS Certificate Setup section provides:
- Quick Setup (TLS Tool) - Generate certificates automatically (recommended)
- Alternative (Installer) - Use the installer method
- Configuring TLS - Configure transport and REST layer TLS
- Certificate Revocation - Implement certificate revocation
- TLS Hot Reload - Reload certificates without restart
3. Verify Compatibility
Check the Versions and Compatibility section to ensure you’re using compatible versions:
- Available Versions - Download links for all versions
- Compatibility Matrix - Elasticsearch/Search Guard version compatibility
- End of Life Policy - Support lifecycle information
4. Upgrade or Migrate (If Needed)
If upgrading an existing installation or migrating from classic Search Guard, see Upgrades and Migrations:
- Upgrading Between Minor Versions - Standard upgrade process
- Upgrading from FLX 1.x to 2.x - Major version upgrade guide
- Upgrading from 7.x to 8.x - Cross-major version upgrade
- Migrating from Classic to FLX - Migration from pre-FLX versions
Prerequisites
Before installation, ensure you have:
- Compatible Elasticsearch version installed
- Java 11 or higher (Java 17 recommended)
- Sufficient disk space for plugin installation
- Network access to download Search Guard plugins
Next Steps
After completing installation and setup, proceed to Configuration to configure users, roles, and permissions.