Help › Troubleshooting

My CI run failed

Partly builtLast updated

Each message in a failed run says what to fix. Run rl doctor first. It explains most of these.

You seeWhat it meansWhat to do
Secret key rejected (401)The key is missing, wrong, revoked or expiredStore a valid key as a CI secret. On GitLab mark it Masked and Protected
Not allowed to do this (403)The key lacks a scope, or is limited to another siteA sync needs strings:write, translations:write and bundles:publish. A preview needs sites:read and translations:read
Account suspended (403)Changes are refused. Published translations keep servingContact support
Plan, allowance or licence limit (402)A plan limit, not a permission problemSee What the limit messages mean. Upgrade, or wait for the reset date
Service unavailable or busy (503 or 429)Our control plane is busy or down. The tool already retried. Your published translations keep being servedRun again later. A scheduled sync can be set to warn instead of fail
The job failed or timed outA translate or publish job did not finishLook at the job, and raise the timeout
"Offline count only" in a previewThe run had no key, for example a fork pull requestExpected. A maintainer can run it again
Could not post the commentThe token is read-onlyGive the workflow permission to write pull requests
Bundle integrity check failedA signature, checksum or version check refused the filesCheck the site key and public key. During a key change, list both keys
hreflang check failedThe output has links without return links, relative links or no defaultFix the pages listed. Hand-written alternate links in your source pages are the usual cause

Never do this#

The CI tools are in the repository and not published: OPEN.

Do not paste a secret key into a ticket or a chat. Give us the run time, the site name and the error text.