BLOG
When something breaks
The errors a self-hosted support site produces, each with the cause and the fix, written down so you do not meet them at the wrong moment. 14 guides, newest first. Back to every guide.
Troubleshooting
14 articles
TROUBLESHOOTING
redirect_uri_mismatch when you add Google or Microsoft sign-in
The callback your board sent does not match the one you registered. Nine times out of ten it sent http and you registered https.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
pg_restore says unsupported version in file header
The number in that message is the archive format, not a Postgres version, and it tells you exactly which client wrote the file.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Your support site's custom domain is stuck on Verifying
The record is in your DNS panel and the host still cannot see it. Here is how to find out why, with four commands.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Your host blocks the SMTP port, so nothing sends
The connection hangs and then times out. That is your provider's firewall, not your configuration, and the fix depends on which provider you are on.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Your board half-loads behind an HTTPS reverse proxy
The page arrives over HTTPS while its scripts, links and emails come out as http, because nobody told the app that TLS happened.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Your Slack and Discord alerts went quiet
A disabled integration looks exactly like a quiet week. Here is how to tell the difference before you lose a month of reports.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
The sign-in email never arrives, and now nobody can log in
No error, no bounce, no email, and a passwordless install has no other way in. Here is how to find where the message stopped.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
SPF says permerror, too many DNS lookups
Your record is over the ten-lookup limit, or there are two of them. Both are hard failures in the standard, and both make every message you send unauthenticated.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Postgres will not start: database files are incompatible with server
The image tag rolled to a new major version, and Postgres cannot open a data directory the previous one wrote.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Let's Encrypt will not issue your certificate
Before you retry again, read the rate limits. Five issuances of the same name in a week is the wall, and it refills at one every 34 hours.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
Gmail bounced it: 550 5.7.26 unauthenticated email
The message reached Google and was refused for failing authentication. There are three different 5.7.26 texts, and each one points at a different record.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
ERR_TOO_MANY_REDIRECTS after you turned on Cloudflare
Flexible mode fetches your origin over plain HTTP while your server redirects plain HTTP to HTTPS, and the two argue until the browser gives up.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
535 5.7.8 username and password not accepted
Your support centre cannot log in to send mail. Here is what the mail server is rejecting, and the fix for Gmail, Google Workspace and Microsoft 365.
Last updated 23 August 2026 · 7 min read
TROUBLESHOOTING
502 Bad Gateway between your proxy and your container
Connection refused while connecting to upstream nearly always means the proxy is dialling its own loopback rather than the app.
Last updated 23 August 2026 · 7 min read