This section of the Graylog documentation provides guidance on upgrading to recent versions of Graylog. If you are upgrading from an older version, be sure to begin by reading the Upgrade Path documentation to guide you through an incremental upgrade process.
Upgrade Guides by OS
When upgrading from a previous version of Graylog, follow the previously used installation method (e.g. operating system package) using the new version numbers.
Upgrade Notes by Version
The following upgrade notes should be read carefully before you start the upgrade process. Breaking changes and dependency upgrades are documented in those upgrade notes.
Upgrade Graylog Originally Installed from Package
If the current installation was completed using a package manager (ex. yum, apt), update the repository package to the target version and use the system tools to upgrade the package. For rpm-based systems see this update guide. For deb-based systems see this update guide.
Version Compatibility
Prior to upgrading, consult the following table for compatibility with supported versions of OpenSearch and MongoDB.
| Graylog Version | Minimum MongoDB Version | Maximum MongoDB Version | Minimum Elasticsearch Version | Maximum Elasticsearch Version | Minimum OpenSearch Version | Maximum OpenSearch Version |
|---|---|---|---|---|---|---|
| 4.0.x | 3.6 | 4.2 | 6.8 or 7.0 | 7.1 | Not Supported | Not Supported |
| 4.1.x | 3.6 | 4.4 | 6.8 or 7.0 | 7.1 | Not Supported | Not Supported |
| 4.2.x | 3.6 | 4.4 | 6.8 or 7.0 | 7.10.2 | Not Supported | Not Supported |
| 4.3.x | 3.6 | 5.0 | 6.8 or 7.0 | 7.10.2 | 1.1.x (or 1.3.x for Graylog Security) | 1.3.x |
|
5.0.x |
5.0 |
6.x |
7.10.2 |
7.10.2 |
1.1.x (or 1.3.x for Graylog Security) |
2.13.x |
|
5.1.x |
5.0 |
6.x |
7.10.2 |
7.10.2 |
1.1.x (or 1.3.x for Graylog Security) |
2.13.x |
|
5.2.x |
5.0.7 |
6.x |
7.10.2 |
7.10.2 |
1.1.x (or 1.3.x for Graylog Security) |
2.13.x |
|
6.0.x |
5.0.7 |
7.x |
7.10.2 |
7.10.2 |
1.1.x (or 1.3.x for Graylog Security) |
2.15.x |
|
6.1.x |
5.0.7 |
7.x |
7.10.2 |
7.10.2 |
1.1.x (or 1.3.x for Graylog Security) |
2.15.x |
