Install Kong Gateway on macOS

    You have root-equivalent access.

    Install Kong Gateway:

    Use the Homebrew package manager to add Kong as a tap and install it:

    Kong can run either with or without a database.

    When using a database, you will use the configuration file for setting Kong’s configuration properties at start-up and the database as storage of all configured entities, such as the Routes and Services to which Kong proxies.

    We don’t recommend using Cassandra with Kong Gateway, because support for Cassandra is .

    Configure Kong so it can connect to your database. Kong supports and Cassandra as datastores, and can also run in

    1. If you are using Postgres, provision a database and a user before starting Kong:

      1. CREATE USER kong; CREATE DATABASE kong OWNER kong;
    2. Run the Kong migrations:

      By default, Kong is configured to communicate with a local PostgreSQL instance. If you are using Cassandra, or need to modify any settings, download the kong.conf.default file and it as necessary.

      1. sudo mkdir -p /etc/kong
      2. sudo cp kong.conf.default /etc/kong/kong.conf

    Without a database

    If you are going to run Kong in , you should start by generating a declarative config file.

    1. Edit your kong.conf file. Set the option to off and the declarative_config option to the path of your kong.yml file:

      1. database = off
    1. Start Kong Gateway:

      1. curl -i http://localhost:8001/

    Check out Kong Gateway’s series of Getting Started guides to get the most out of Kong Gateway.