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 customizations 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:
- Docker & Kubernetes - Docker Hub - https://hub.docker.com/u/tykio
- Helm install - Artifact Hub - https://artifacthub.io/packages/search?repo=tyk-helm
- Linux - Packagecloud - https://packagecloud.io/tyk
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 Center 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.