Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kubernetes Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kubernetes Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
  • 3.3.x (latest)
  • 3.2.x
  • 3.1.x
  • 3.0.x
  • 2.8.x
  • 2.7.x
  • 2.6.x
  • Older Enterprise versions (2.1-2.5)
  • Older OSS versions (2.1-2.5)
  • Archive (pre-2.1)

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

On this pageOn this page
  • Prerequisites
  • Migration steps
Kong Gateway
3.3.x (latest)
  • Home
  • Kong Gateway
  • Migrating from Kong Gateway (OSS) to Kong Gateway

Migrating from Kong Gateway (OSS) to Kong Gateway

Run kong migrations commands to migrate from an open-source Kong Gateway installation to an Enterprise one.

You can only migrate to a Kong 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 Enterprise.

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

Migration steps

The following steps guide you through the migration process.

  1. Download the Kong Gateway 3.3.x Enterprise 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 finish [-c configuration_file]
    
  2. Confirm that all of the entities are now available on your Kong Enterprise node.

Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023