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.

Hint: The upgrade notes are always written as if you are upgrading from the last stable release before.

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

Warning: We caution you not to install or upgrade to Elasticsearch 7.11+ or OpenSearch 2.16+! It is not supported. Doing so will break your instance!