Back to docs

Fix issues faster

Common realtime problems and fixes

Most realtime issues come from wrong keys, blocked origins, missing channel authorization, or usage limits.

Problem

Client cannot connect

Likely cause

The public key may be wrong, the app may be disabled, or the gateway host may be incorrect.

Fix

Check the app keys page, app status, and gateway value shown in the console.

Problem

Origin blocked

Likely cause

The website trying to connect is not listed as a trusted origin for that app.

Fix

Open the app, add the exact website origin, then retry the connection.

Problem

Private channel denied

Likely cause

The channel authorization response may be missing, invalid, or signed with the wrong secret.

Fix

Check your trusted server route, socket ID, channel name, and active secret key.

Problem

Presence join fails

Likely cause

Presence channels require valid channel data with user information.

Fix

Return signed authorization with valid user data for the connected member.

Problem

Usage limit reached

Likely cause

The app has reached the monthly event or message limit for the current plan.

Fix

Review usage, reduce traffic, or upgrade the workspace plan when billing is ready.