ReqtapDocs

Troubleshooting

Common local and self-hosting issues.

Dashboard cannot reach the API

Check NUXT_PUBLIC_API_BASE, CORS, and that GET /health returns status: ok.

Signature shows invalid

Confirm the endpoint signing secret, provider header, and that no proxy rewrites the request body.

Forwarding reaches the wrong path

If the target URL has no path, Reqtap appends the captured request path. Include an explicit path to override it.

Docker build fails locally

Make sure Docker or OrbStack is running. docker compose config can validate configuration without starting containers.