Upgrading Tyk

Last updated: 3 minutes read.

This section provides detailed guides and recommendations for upgrading your Tyk installation.

When upgrading Tyk, consider the following:
Deployment model: SaaS, Self-Managed, Hybrid, or OSS.
Installation type: Docker, Helm, K8S, or various Linux distributions.
Components: Depending on your model, upgrade relevant components such as Gateway, Pump, Dashboard, or Go Plugins.

These considerations are reflected in our structured upgrade guides, ensuring you have all necessary information in one place.

Standards and recommendations

Our upgrade process adheres to the following standards:

  • Breaking changes: Breaking changes are rare and will be explicitly stated in the release notes.

  • Configuration files: Upgrades do not overwrite your configuration files. However, it’s good practice to routinely back up these files (using git or another tool) before upgrading, so any customisations are saved.

  • Migration scripts: Migration scripts for your APIs, policies, or other assets are generally not required unless specified in the release notes.

  • Long Term Support: Refer to our versioning and long-term support policies for details on major and minor releases, patches, and support dates.

  • Preparations: Review the preparation guidelines before starting the upgrade.

  • Release notes: Always check the “Upgrade Instructions” section in the relevant release notes.

  • Backups: Follow our comprehensive backup guide before starting the upgrade.

  • Docker: Upgrading with Docker is straightforward—pull the new images from public repositories. Refer to the following links for our releases:

  • Docker: Upgrading with Docker is straightforward - pull the new images from public repositories. Refer to the following links for our releases:

    The above repositories will be updated when new versions are released

  • If you experience issues with the new version you pulled, contact Tyk Support or visit Tyk community forum.

Upgrade Guides ToC

Use the table below to find the appropriate upgrade guide for your platform:

Platform Guide Description
Tyk Cloud Cloud SaaS Guide to Tyk Cloud SaaS
Hybrid Guide for Hybrid environments with Gateway Data Plane(s) deployed locally or with a third-party cloud provider
Go plugin Guide for upgrading Go plugin on the Tyk Cloud
Tyk Self Managed RHEL and CentOS Guide for RPM-based Linux distributions
Debian and Ubuntu Guide for DEB-based Linux distributions
Docker Guide for upgrading Docker images
Helm Guide for upgrading Helm Charts
Kubernetes Guide for upgrading Kubernetes environment
Tyk MDCB Self Managed MDCB Guide for upgrading Mutli Data Centre Bridge (MDCB)
Tyk Open Source Tyk Gateway Guide for upgrading Tyk open source environment

Supporting Tools

Tyk offers supporting tools for database migration and backing up APIs and policies.

Migrating from MongoDB to SQL

Use our migration tool to manage the switch from MongoDB to SQL.

Backup APIs Script

Utilize our bash backup script to export and restore all Tyk API Definitions and Policies.

Don’t Have Tyk Yet?

Get started now for free, or contact us with any questions.