Tyk v2.2 Documentation Components

HomeTyk v2.2 Documentation ComponentsInstall the Hybrid Gateway

Install the Hybrid Gateway

To Install a Tyk Hybrid Gateway, you will need to ensure some basic requirements are met.


  1. A Docker-enabled host
  2. Access to the shell of this host
  3. Port 80, 8080 and 9090 open
  4. A Tyk Cloud account

Step 1: Get your credentials

  1. Go to https://admin.cloud.tyk.io and login with your new details.
  2. Click “Users” and select your name, you will see your RPC credentials, take note of these:

    RPC credentials

Step 2: Get Tyk installed

To get started with a hybrid node, ensure you have Docker installed, then run the following in the terminal:

For OS X users, open a CLI that can access the docker command, and then:

curl "https://raw.githubusercontent.com/lonelycode/tyk-hybrid-docker/master/start.sh" -o "start.sh"
chmod +x start.sh

For Linux users:

wget https://raw.githubusercontent.com/lonelycode/tyk-hybrid-docker/master/start.sh
chmod +x start.sh

The parameters explained:

  • PORT: The port for Tyk to listen on (usually 8080).
  • TYK-SECRET: The secret key to use so you can interact with your Tyk node via the REST API.
  • RPC-CREDENTIALS: Your organisation ID, this can be found in the Dashboard Users -> User section.
  • API-CREDENTIALS: Your Tyk Cloud API credentials – these can be found in the Users section of your dashboard.

The TYK-SECRET should be a secret key you define so you can interact with your Tyk node programatically.

This command will start the Docker container and be ready to proxy traffic (you will need to check the logs of the container to make sure the login was successful).

Step 3: Check everything is working

To check if the node has connected and logged in, type:

sudo docker logs --tail=100 --follow tyk_hybrid

This will show you the log output of the hybrid container, if you don’t see any connectivity errors, and the log output ends something like this:

time="Jul  7 08:15:03" level=info msg="Gateway started (vx.x.x.x)"
time="Jul  7 08:15:03" level=info msg="--> Listening on port: 8080"

Then the gateway has successfully started.

Was this article helpful to you? Yes No