Troubleshooting¶
Resolve connection, sign-in, translation, and PDF layout problems.
The page does not open¶
Cause: cloud-init has not finished, or port 8443 is not forwarded. The translator listens on port 8443 with this instance's certificate.
Fix: wait for cloud-init, run the walkthrough, forward port 8443, and trust that certificate. Do not disable verification. See Open the page.
Sign-in fails¶
Cause: the password in the browser is not the one first boot created.
Fix: read it from /opt/sushi/docs/README.md on the instance. Do not
print it into a ticket.
Translation does not run¶
Cause: /etc/pdf-translator/provider.json is missing the HTTPS service,
model, or key. No key is built into the image.
Fix: save those three values in that file after launch, then translate the bundled one-page sample. A successful sample produces a Spanish PDF and a bilingual PDF.
The layout does not match a scanned PDF¶
Cause: the listing describes digital English PDFs and keeping the original page layout. It does not describe scanned pages.
Fix: use a digital English PDF, starting with the bundled one-page sample.
Last updated November 1, 2026 · Suggest an improvement