1 Troubleshooting
Théophile Diot edited this page 2025-10-22 14:17:22 +02:00

Import fails: invalid key

  • Cause: setting names must match multisite keys exactly.
  • Fix: compare against docs or a known-good template.

Import fails: missing config file

  • Cause: configs path not found under template root.
  • Fix: ensure the file exists and the path matches exactly.

502/504 to upstream

  • Check REVERSE_PROXY_HOST/URL and network reachability.
  • Adjust timeouts for streaming or slow backends if needed.

Let's Encrypt errors

  • Verify domain DNS; use USE_LETS_ENCRYPT_STAGING=yes for testing.
  • For DNS challenge: set LETS_ENCRYPT_DNS_PROVIDER and credentials.

Aggressive rate limiting

  • Narrow LIMIT_REQ_URL* to specific paths (e.g., /wp-login.php, /xmlrpc.php).
  • Increase LIMIT_REQ_RATE* for chatty APIs or sync clients.

JSON formatting

  • Run: jq . templates//template.json
  • Ensure no trailing commas and quotes are correct.

Still stuck? Check README.md and ask on Discord: https://discord.gg/YEdMKqztMZ