Gateway troubleshooting
Most gateway issues come down to the upstream URL, the profile, or the port. Start with neuraframe status and neuraframe logs.
Requests return a 502 saying the provider is unreachable
This is honest failure working as intended: the request was not in memory and the Gateway could not reach your provider. Check that gateway.upstream_url is correct and reachable from the host, that outbound network and any firewall allow it, and that your provider is up. Anything already learned still serves from memory.
neuraframe config get gateway
curl -sS https://api.your-provider.com -o /dev/null -w "%{http_code}\n"
Everything is forwarded and nothing is reused
Two common causes. First, the license may be missing or expired, in which case the Gateway is in transparent pass-through by design; run neuraframe status. Second, the profile may not match your provider, so the meaning layer is off; set gateway.profile to your provider or auto and restart. The exact layer still reuses identical repeats regardless of profile.
My provider rejects the request (401 or 403)
The Gateway forwards your API key untouched, so an auth error almost always means the key or auth header did not travel from your app. Confirm your app still sends its usual header (Authorization: Bearer for OpenAI and xAI, x-api-key plus anthropic-version for Anthropic). NeuraFrame™ does not add, store, or require a provider key of its own.
Port already in use
Another process is on the gateway's listen port. Change it and restart.
neuraframe config set gateway.listen 127.0.0.1:8082 sudo systemctl restart neuraframe-studio
Streaming looks different through the gateway
It should not: a miss forwards the request unchanged and returns the response unchanged, byte identical, including streamed tokens. If a streamed response differs, you are likely pointing at a different upstream path than before. Confirm the base URL and path in the provider table.
Still stuck
Collect neuraframe doctor output and recent neuraframe logs, then reach us from the contact page.