You are browsing documentation for an older version. See the latest documentation here.

Migrating from Kong Gateway (OSS) to Kong Gateway Enterprise

Run kong migrations commands to migrate from a Kong Gateway (OSS) installation to Kong Gateway Enterprise.

You can only migrate to a Kong Gateway Enterprise version that supports the same Kong Gateway (OSS) version.

Prerequisites

Warning: This action is irreversible, therefore it is strongly recommended to back up your production data before migrating from Kong Gateway (OSS) to Kong Gateway Enterprise.

If running a version of Kong Gateway (OSS) earlier than 3.5.x, upgrade to Kong Gateway (OSS) 3.5.x before migrating Kong Gateway (OSS) to Kong Gateway Enterprise 3.5.x.

Migration steps

The following steps guide you through the migration process.

Download the Kong Gateway Enterprise 3.5.x package and configure it to point to the same data store as your Kong Gateway (OSS) node. The migration command expects the data store to be up to date on any pending migration:
```
kong migrations up [-c configuration_file]
kong migrations -f finish [-c configuration_file]
```
Caution: When adding new plugins to the existing installation (either manually or via the extension of bundled plugins), the kong migrations finish or kong migrations up must be run with the -f flag to forcefully upgrade the plugin schemas.
Confirm that all of the entities are now available on your Kong Gateway Enterprise node.