Skip to content
Kong Logo | Kong Docs Logo
search
  • We're Hiring!
  • Docs
    • Kong Gateway
    • Kong Konnect
    • Kong Mesh
    • Plugin Hub
    • decK
    • Kong Ingress Controller
    • Insomnia
    • Kuma

    • Docs contribution guidelines
  • Plugin Hub
  • Support
  • Community
  • Kong Academy
Get a Demo Start Free Trial
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Plugin Hub
  • decK
  • Kong Ingress Controller
  • Insomnia
  • Kuma

  • Docs contribution guidelines
  • 3.3.x (latest)
  • 3.2.x
  • 3.1.x
  • 3.0.x
  • 2.8.x
  • 2.7.x
  • 2.6.x
  • Older Enterprise versions (2.1-2.5)
  • Older OSS versions (2.1-2.5)
  • Archive (pre-2.1)

github-edit-pageEdit this page

report-issueReport an issue

enterprise-switcher-iconSwitch to OSS

Kong Gateway
3.0.x
  • Home
  • Kong Gateway
  • Kong Enterprise
  • Dev Portal
  • Enable the Dev Portal
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.

Docker
Linux (kong.conf)
  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:

    Kong Manager
    Admin API
    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"
Thank you for your feedback.
Was this page useful?
  • Kong
    THE CLOUD CONNECTIVITY COMPANY

    Kong powers reliable digital connections across APIs, hybrid and multi-cloud environments.

    • Company
    • Customers
    • Events
    • Investors
    • Careers Hiring!
    • Partners
    • Press
    • Contact
  • Products
    • Kong Konnect
    • Kong Gateway
    • Kong Mesh
    • Get Started
    • Pricing
  • Resources
    • eBooks
    • Webinars
    • Briefs
    • Blog
    • API Gateway
    • Microservices
  • Open Source
    • Install Kong Gateway
    • Kong Community
    • Kubernetes Ingress
    • Kuma
    • Insomnia
  • Solutions
    • Decentralize
    • Secure & Govern
    • Create a Dev Platform
    • API Gateway
    • Kubernetes
    • Service Mesh
Star
  • Terms•Privacy
© Kong Inc. 2023