To Install a Tyk Hybrid gateway, you will need to ensure some basic requirements are met.
- A docker-enabled host
- Access to the shell of this host
- Port 80, 8080 and 9090 open
- A Tyk Cloud account
Step 1. Get your credentials
- Go to https://admin.cloud.tyk.io and login with your new details
Click “Users” and select your name, you will see your RPC credentials, take note of these:
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 OSX 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 ./start.sh [PORT] [TYK-SECRET] [RPC-CREDENTIALS] [API CREDENTIALS]
For Linux users:
wget https://raw.githubusercontent.com/lonelycode/tyk-hybrid-docker/master/start.sh chmod +x start.sh sudo ./start.sh [PORT] [TYK-SECRET] [RPC-CREDENTIALS] [API CREDENTIALS]
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 CREDENTIALSYour 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.