Troubleshooting
Troubleshooting
Section titled “Troubleshooting”Crowdin token not found
Section titled “Crowdin token not found”Typical error:
No API token foundCheck one of these:
~/.config/clawdie/crowdin-token.envin the host repo- exported
CROWDIN_PERSONAL_TOKEN
Then verify:
cd /home/<agent>/clawdie-ai./scripts/crowdin-sync.sh --statusPush or pull fails against Crowdin
Section titled “Push or pull fails against Crowdin”Check:
- the token is valid
- the project still exists in Crowdin
- the target language is enabled there
Then retry:
./scripts/crowdin-sync.sh --push./scripts/crowdin-sync.sh --pullA locale folder is missing after pull
Section titled “A locale folder is missing after pull”Check whether translators actually produced content for that locale.
Expected output paths look like:
docs/public/sl/docs/public/de/
If the locale is empty or missing, the issue is usually upstream in Crowdin, not in Astro.
Localized page does not appear on the site
Section titled “Localized page does not appear on the site”First make sure the translated markdown exists in the repo.
Then redeploy from the cms jail project:
cd /usr/home/<tenant>/<tenant>-sitenpm run deployIf that succeeds, verify the live route with curl.
Build fails inside the cms jail
Section titled “Build fails inside the cms jail”Remember the current runtime path is:
/usr/home/<tenant>/<tenant>-site/
Not:
/home/clawdie/astro-docs/
If an error message or an old note points at astro-docs, treat it as historical guidance and switch back to the current cms-jail path.
Docs deploy works, but translations still look stale
Section titled “Docs deploy works, but translations still look stale”Check whether the translated markdown was actually pulled into git before deploy:
cd /home/<agent>/clawdie-aigit diff -- docs/public/sl docs/public/deIf there are no new locale changes, the deploy is probably working and the content simply was not updated yet.
Tenant sites disappeared after a docs deploy
Section titled “Tenant sites disappeared after a docs deploy”That should not happen anymore.
The current docs deploy path protects:
/usr/local/www/<tenant>/sites/
If tenant-site output was still removed, inspect the deploy script in the Astro project and confirm the protected-path behavior is still present.