Install Kong Gateway on macOS

    Kong Gateway (OSS) is licensed under an .

    You have a supported system with root or root-equivalent access.

    Install Kong Gateway:

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

    Kong can run either with or without a database.

    When not using a database, you will use kong.conf’s configuration properties and a kong.yml file for specifying the entities as a declarative configuration.

    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 Postgres instance. If you are using Cassandra, or need to modify any settings, download the kong.conf.default file and it as necessary.

    3. As root, add kong.conf.default to :

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

    Without a database

    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:

    2. Verify that Kong Gateway is running:

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

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