macOS Installation

Packages

• Homebrew Formula

---

Installation

1. Install Kong

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

    $ brew tap kong/kong
    $ brew install kong
   

2. Prepare your database

   Configure Kong so it can connect to your database. Kong supports both PostgreSQL 9.5+ and Cassandra 3.x.x as its datastore.

   If you are using Postgres, please provision a database and a user before starting Kong, ie:

    CREATE USER kong; CREATE DATABASE kong OWNER kong;
   

   Now, run the Kong migrations:

    $ kong migrations up [-c /path/to/kong.conf]
   

   Note: migrations should never be run concurrently; only one Kong nodes should be performing migrations at a time.

3. Start Kong

    $ kong start [-c /path/to/kong.conf]
   

4. Use Kong

   Kong is running:

    $ curl -i http://localhost:8001/
   

   Quickly learn how to use Kong with the 5-minute Quickstart.

---