Skip to content

Troubleshooting

SymptomCauseFix
Pipeline green, site not reachableHOST was not set when the pipeline ran; the pod has no ingressSet HOST, push a commit
Pipeline green, certificate warningThe certificate is still being issued; the ingress answers with a placeholder for a minute or twoWait, reload
Build fails on the first line, 403 or unauthorized on the builder imageThe deploy token is missing or lacks read_registryCreate gitlab-deploy-token
Preview branch deploys to an empty hostThe branch is not protected, so protected HOST/K8S_CLUSTER are empty thereProtect pr-* and dev
Engine was updated, site unchangedThe pipeline was re-run on the old commit — same tag, no rollPush a commit, empty if need be (Updating the engine)
Contact form says “Something went wrong”The Turnstile site key does not match the receiver’s, or the widget failed to loadCheck turnstileSiteKey and contactFormReceiverURL; reload the page
Search does nothing behind the passwordThe page was opened from a URL with credentials in itOpen the plain URL and log in through the dialog
A page from the repository shows the DockerfileThe knowledge-base Dockerfile lost its second rm -rfRestore it from the template
A picture is missing in a landing pageThe file name in image= does not match a file in images/Names are case-sensitive and relative to images/