Quick fixes for common setup issues

Most setup failures come from mismatched Discord redirects, missing intents, or public access that is not terminating TLS.

Invalid OAuth2 redirect_uri

Copy the exact redirect URI shown in Settings > Web UI into Discord's OAuth2 > Redirects. Scheme, host, port, path, and trailing slash all matter.

Integration requires code grant

Turn off Requires OAuth2 Code Grant in Discord unless you need it. If it must stay on, configure SwiftBot's Discord OAuth settings first.

Bot logs in but cannot see members or messages

Enable Server Members Intent and Message Content Intent in the Discord Developer Portal, then restart SwiftBot.

Cloudflare hostname shows 502 Bad Gateway

Confirm the Admin Web UI is enabled, the local port matches the SwiftBot setting, and the Cloudflare tunnel checklist is green. Restart SwiftBot if the tunnel process is stale.

Standby cannot pair across the internet

Check that the Primary's mesh port is forwarded to the Primary Mac, macOS Firewall allows SwiftBot inbound, and the ISP is not blocking inbound traffic with CGNAT.

Still stuck?

Open an issue on GitHub with what you tried and any relevant log output, and we'll help you track it down.