Skip to content
2023 API Summit Hackathon: Experiment with AI for APIs (August 28 - September 27) Learn More →
|
search
Kong Gateway
3.1.x
github-edit-pageEdit this page
report-issueReport an issue
You are browsing documentation for an outdated version. See the latest documentation here.

Enable the Dev Portal

If you’re running Kong Gateway with a database (either in traditional or hybrid mode), you can use the Dev Portal.

Dev Portals are tied to workspaces. Each workspace has a separate Dev Portal instance.

Enabling the Dev Portal exposes the following URLs:

  • The workspace’s Dev Portal URL. For example, for the default workspace, the URL is: http://localhost:8003/default.
  • Dev Portal files endpoint: http://localhost:8001/files
  • Public Dev Portal files API: http://localhost:8004/files

To enable the Dev Portal, you must first deploy a license.

  1. In your Docker container, set the Portal URL and set KONG_PORTAL to on:

     echo "KONG_PORTAL_GUI_HOST=localhost:8003 KONG_PORTAL=on kong reload exit" \
   | docker exec -i kong-container-name /bin/sh

    Replace kong-container-name with your Kong Gateway container.

    The HOSTNAME for KONG_PORTAL_GUI_HOST should not be preceded by a protocol. For example, http://.

  2. Enable the Dev Portal for a workspace:

     curl -i -X PATCH http://localhost:8001/workspaces/default \
   --data "config.portal=true"

  3. Access the Dev Portal for the workspace using the URL specified in the KONG_PORTAL_GUI_HOST variable:

     http://localhost:8003/default

  1. To enable the Dev Portal, the following property must be set in the Kong configuration file (kong.conf):

    portal = on

    Restart Kong Gateway for this value to take effect:

    kong reload

  2. Enable Dev Portal for a workspace using one of the following methods:

    1. Navigate to a workspace in Kong Manager.
    2. In the Dev Portal menu section, click Overview.
    3. Click the button to Enable Developer Portal. 
    curl -i -X PATCH http://localhost:8001/workspaces/default \
  --data "config.portal=true"