Debugging

See what's happening under the hood.

One of Relay's most powerful features is the built-in terminal for every server.

Viewing Logs

To view the logs for a running server:

  1. Go to the Servers list.
  2. Locate the server card.
  3. Click the Terminal icon.

Understanding the Output

The log window displays two types of output:

  • stdout: Standard output. This typically contains the JSON-RPC messages (if not hidden) or info logs.
  • stderr: Standard error. This is where most servers print debug information, warnings, and crash reports.

Common Errors

  • Module not found: You need to install dependencies (npm install).
  • 401 Unauthorized: Your API key is missing or invalid. Check your environment variables.
  • EADDRINUSE: The server is trying to bind to a port that's already taken.