> ## Documentation Index
> Fetch the complete documentation index at: https://tyk-docs-dx-2014-oauth2-keycloak-tib-example.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation Options for Tyk Self-Managed

> Explore the various installation options for Tyk Self-Managed, including Docker, Kubernetes, Linux packages, Ansible, and more.

export const ResponsiveGrid = ({children}) => {
  return <div className="responsive-grid">
      {children}
    </div>;
};

| Edition    | Deployment Type      |
| :--------- | :------------------- |
| Enterprise | Self-Managed, Hybrid |

<Note>
  This page is for installing **Tyk Self-Managed**. If you are looking to use Tyk as part of **Tyk Cloud**, please refer to [the Tyk Cloud documentation](/getting-started/create-account).
</Note>

## Architecture

<img src="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/jyJn5PQelPmiNWX5/img/diagrams/tyk-selfmanaged-architecture.png?fit=max&auto=format&n=jyJn5PQelPmiNWX5&q=85&s=46ab53f879967de4019aefb59bc2b265" alt="Tyk Self-Managed Architecture" width="1060" height="860" data-path="img/diagrams/tyk-selfmanaged-architecture.png" />

## Requirements

**Tyk Dashboard** requires a persistent datastore for its operations. By default MongoDB is used. From Tyk v4.0, we also support PostgreSQL.

### PostgreSQL

| Tyk Version      | PostgreSQL Version          |
| ---------------- | --------------------------- |
| From 5.X onwards | PSQL 14.x, 15.x, 16.x, 17.x |

You can also use the following as a drop in replacement for PostgreSQL:

* [Amazon RDS](https://aws.amazon.com/rds/)
* [Amazon Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.AuroraPostgreSQL.html)
* [Azure CosmosDB for PostgreSQL](https://learn.microsoft.com/en-us/azure/cosmos-db/postgresql/introduction)
* [Sqlite](https://www.sqlite.org/index.html) (for development and testing only)

<Note>
  SQLite support will be deprecated from Tyk 5.7.0. To avoid disruption, please transition to PostgreSQL, MongoDB or one of the listed compatible alternatives.
</Note>

Please check [here](/planning-for-production/database-settings#postgresql) for production configuration.

### MongoDB

| Tyk Version      | MongoDB Version |
| ---------------- | --------------- |
| From 5.X onwards | MongoDB 7.0.x   |
| From 5.9 onwards | MongoDB 8.0.x   |

You can also use the following as a drop-in replacement for MongoDB:

* [Amazon DocumentDB](https://aws.amazon.com/documentdb/) 3.6 and 4 engine
* [Azure Cosmos DB for MongoDB](https://learn.microsoft.com/en-us/azure/cosmos-db/mongodb/introduction) 3.6 and 4 engine

Please check [here](/planning-for-production/database-settings#mongodb) for MongoDB driver and production configuration.

### Redis

**Tyk Gateway** requires Redis for its operations. Here is the list of supported versions:

| Tyk Version          | Redis Version                      |
| -------------------- | ---------------------------------- |
| From 5.0.x to 5.8.x  | 6.2.x, 7.x                         |
| From 5.9.x to 5.11.x | 6.2.x, 7.x, 7.4.x, 8.x (up to 8.2) |
| From 5.12.x onwards  | 6.2.x, 7.x, 7.4.x, 8.x (up to 8.4) |

Visit the [Redis page](/planning-for-production/database-settings#redis) for more info.

## Recommended Installation: Docker

For development, testing, and proof of concept purposes, we recommend using our Docker installation, which allows you to quickly spin up a full Tyk stack on your local machine.

<ResponsiveGrid>
  <Card href="/tyk-self-managed/install/docker" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/jyJn5PQelPmiNWX5/img/docker.png?fit=max&auto=format&n=jyJn5PQelPmiNWX5&q=85&s=bc297e938d4f3b2bc19f95df799c4a33" width="71" height="61" data-path="img/docker.png">
    Install with Docker
  </Card>
</ResponsiveGrid>

## Alternative Installation Methods

<ResponsiveGrid>
  <Card href="/tyk-self-managed/install/kubernetes" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/yU2fLTpSC8NHp7IT/img/k8s.png?fit=max&auto=format&n=yU2fLTpSC8NHp7IT&q=85&s=6f90da1e34266ac5754b6243dad95204" width="70" height="69" data-path="img/k8s.png">
    Install on K8s
  </Card>

  <Card href="/tyk-self-managed/install/methods#install-with-ansible" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/8Kgzb-nlrzuk8veO/img/ansible.png?fit=max&auto=format&n=8Kgzb-nlrzuk8veO&q=85&s=4361c0a28632f7b3681d1cef4f92bebc" width="80" height="80" data-path="img/ansible.png">
    Install with Ansible
  </Card>

  <Card href="/tyk-self-managed/install/linux#install-tyk-on-redhat-rhel-centos" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/kToOQUIqQr-wLRAx/img/redhat-logo2.png?fit=max&auto=format&n=kToOQUIqQr-wLRAx&q=85&s=7fb079cf082109bf90bd0e8d1ad850c0" width="70" height="55" data-path="img/redhat-logo2.png">
    Install on Red Hat
  </Card>

  <Card href="/tyk-self-managed/install/linux#install-tyk-on-debian-or-ubuntu" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/KAYP8MwoSjjF5RCh/img/debian-nd-753.png?fit=max&auto=format&n=KAYP8MwoSjjF5RCh&q=85&s=77026ae2a77c44804672ded7825e4977" width="57" height="69" data-path="img/debian-nd-753.png">
    Install on Ubuntu
  </Card>

  <Card href="/tyk-self-managed/install/methods#install-on-aws-marketplace" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/8Kgzb-nlrzuk8veO/img/aws.png?fit=max&auto=format&n=8Kgzb-nlrzuk8veO&q=85&s=2a14089d3a7c7334f13c6783dc248423" width="71" height="43" data-path="img/aws.png">
    Install on Amazon AWS
  </Card>

  <Card href="/tyk-self-managed/install/methods#install-on-heroku" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/yU2fLTpSC8NHp7IT/img/heroku-logo.png?fit=max&auto=format&n=yU2fLTpSC8NHp7IT&q=85&s=237b4b505eb7c62b857ef5c703f0e13e" width="70" height="73" data-path="img/heroku-logo.png">
    Install Tyk on Heroku
  </Card>

  <Card href="/tyk-self-managed/install/methods#install-on-microsoft-azure" img="https://mintcdn.com/tyk-docs-dx-2014-oauth2-keycloak-tib-example/8Kgzb-nlrzuk8veO/img/azure-2.png?fit=max&auto=format&n=8Kgzb-nlrzuk8veO&q=85&s=53c9ff60feffe46b1095324058e69a94" width="70" height="55" data-path="img/azure-2.png">
    Install on Microsoft Azure
  </Card>
</ResponsiveGrid>

## Air Gapped Installation

For environments with restricted network access, we provide guidance on how to deploy Tyk using private container registries and local package mirrors.

Refer to our [Air-Gapped Deployment guide](/api-management/air-gapped-deployment) for detailed instructions on how to set up Tyk in air-gapped or network-restricted environments.