ZuploZuplo
LoginSign Up
  • Documentation
  • API Reference
Introduction
Getting Started
    Develop using the Portal
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingMCP - Quick start
    Develop Locally
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth
Concepts
Development
    CORSEnvironment VariablesBranch-Based DeploymentsTestingTroubleshootingGitOps vs TerraformCustom Code
    Local Development
      QuickstartRoutes DesignerInstalling PackagesZuplo ServicesDebuggingEnvironment variablesTypeScript ConfigTroubleshooting
    Guides
Policies
Handlers
API Keys
MCP Server
MCP Gateway
AI Gateway
Developer Portal
Monetization
Deploying & Source Control
Observability
Networking & Infrastructure
Account Management
Programming API
Build with AI
Zuplo CLI
Migration Guides
Platform LimitsSecuritySupportTrust & ComplianceChangelog
powered by Zudoku
Local Development

Debugging Locally

You can debug your local gateway through VS Code using its TypeScript debugger. Features such as breakpoints, stepping through the code, variable inspection, etc., will be available to help you debug your gateway.

  1. Create a .vscode/launch.json file with the following content. If you already have an older/existing .vscode/launch.json file, you can add the section in the curly braces to the configurations array. Take note of the port value since that's the value you will specify next.
Code
{ "configurations": [ { "name": "Zuplo Gateway", "type": "node", "request": "attach", "restart": true, "port": 9229 } ] }
  1. Start the gateway in debug mode using the port that you specified above.
TerminalCode
npx zuplo dev --debug-port 9229
  1. Switch to the View > Run and Debug in VS Code. You can now attach the debugger by selecting Zuplo Gateway and clicking the green triangle.

VS code debugging

Limitations

  • We only support stepping through your own module code. System code provided by Zuplo are minified and stripped of source maps, so you won't be able to step through them.
Edit this page
Last modified on March 23, 2026
Zuplo ServicesEnvironment variables
On this page
  • Limitations
JSON