Estimated reading time:
Migrating the Developer Portal from 1.5 to 2.1
Developer Portal migrations are required to upgrade from
Kong Enterprise 1.5 to Kong Enterprise 2.1.
You can make these changes with the Kong templates repository using either the
Kong Portal CLI, or directly in the Kong Developer Portal Editor UI. Using the
CLI to take advantage of source control is recommended.
Links to templates and CLI
The following files must be created for the 2.1 Kong Developer Portal to function
properly. Create each file using the name, path, and contents linked below:
Replace content in existing files
Update the following files that already exist in your Dev Portal workspaces for
1.5.x. Replace the existing contents of the files with the 2.1.x content
Delete obsolete files
You can remove the following files from your Developer Portal.
- Templates Path:
Declare application version
To make future migrations easier, an
app_version declaration has been
portal.conf.yaml as shown below. Add the
app_version to your
current portal configuration files. You can view the complete
portal.conf.yaml file on
For information about upgrading Kong Enterprise, see
Migrating from 1.5.x to 2.1.x.