Troubleshooting

Common issues and how to fix them.

Connection fails

Check host/port. Many TLS IRC servers use port 6697.
Try toggling TLS in the network settings if your server requires plaintext (not recommended).
SASL errors: verify authcid/password and that the server supports your selected mechanism.

TLS / certificate errors

If your server uses a self-signed cert, you may need to enable "Allow invalid certs" for that network (not recommended).

Security warning

Only enable invalid certificates if you understand the risk of man-in-the-middle attacks.

No notifications

Android 13+ requires the notification permission. Enable notifications for the app in Android Settings.
Check the in-app highlight notification settings (sound/vibration).

Always connected doesn't stay connected

Some OEMs aggressively restrict background networking. Try disabling battery optimizations for the app.
Ensure the persistent notification is visible (foreground service running).
Mobile networks and VPNs may interrupt long-lived TCP connections; auto-reconnect can help.

DCC doesn't work

DCC depends on your network setup. NAT/firewalls can block incoming connections.
If sending, configure an appropriate incoming port range in Settings.