Debian / Ubuntu

Supported Distributions

Requirements

• Ensure port 8080 is open: this is used in this guide for Gateway traffic (the API traffic to be proxied).

Install Redis

$ sudo apt-get install -y redis-server

Installation

First import the public key as required by Ubuntu APT

$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927

Run Installation Scripts via our PackageCloud Repositories

From https://packagecloud.io/tyk/tyk-gateway you have the following options:

• Via the correct package for your Ubuntu version. We have packages for the following:

• Xenial

• Trusty

• Precise

• Via Quick Installation Instructions. You can use:

• Manual Instructions

• Chef

• Puppet

• CI and Build Tools

Configuring The Gateway

You can set up the core settings for the Tyk Gateway with a single setup script, however for more involved deployments, you will want to provide your own configuration file.

$ sudo /opt/tyk-gateway/install/setup.sh --listenport=8080 --redishost=<hostname> --redisport=6379 --domain=""

What you’ve done here is told the setup script that:

• --listenport=8080: Listen on port 8080 for API traffic.
• --redishost=<hostname>: The hostname for Redis.
• --redisport=6379: Use port 6379 for Redis.
• --domain="": Do not filter domains for the Gateway, see the note on domains below for more about this.

In this example, you don’t want Tyk to listen on a single domain. It is recommended to leave the Tyk Gateway domain unbounded for flexibility and ease of deployment.

Starting Tyk

The Tyk Gateway can be started now that it is configured. Use this command to start the Tyk Gateway:

$ sudo service tyk-gateway start

Supported Distributions

Requirements

Before you begin the installation process, make sure you have the following:

• Git - required for getting the installation files.
• Ansible is required to run the following commands. Instructions on how install Tyk CE with shell is in the Shell tab.
• Ensure port 8080 is open: this is used in this guide for Gateway traffic (the API traffic to be proxied).

Getting Started

1. clone the tyk-ansible repositry

$ git clone https://github.com/TykTechnologies/tyk-ansible

2. cd into the directory

$ cd tyk-ansible

3. Run initalisation script to initialise environment

$ sh scripts/init.sh

4. Modify hosts.yml file to update ssh variables to your server(s). You can learn more about the hosts file here

5. Run ansible-playbook to install tyk-gateway-ce

$ ansible-playbook playbook.yaml -t tyk-gateway-ce -t redis

Variables

• vars/tyk.yaml

• vars/redis.yaml

Read more about Redis configuration here.