FlashPanel

Troubleshooting ​

A quick list of common problems and the guide that fixes each one. Problems with server connectivity and operation are collected in Server troubleshooting.

Cannot log in over SSH: "Permission denied (publickey)" ​

By default, servers set up by FlashPanel only allow SSH logins with a key, not a password.

  1. Generate an SSH Key on your computer following the SSH Keys guide.
  2. Add the public key to the right user on the server: see Server SSH Keys.
  3. Log in as the user you added the key for, for example ssh flashpanel@SERVER_IP.

If you really need password logins, enable PasswordAuthentication on the SSH page (less secure).

Cron job not running ​

  1. On the server's CronJob page, click View Log to read the error from the last run, or click Run to try the command right away.
  2. Use full paths in the command, because cron jobs do not run inside the website folder.
  3. Check the schedule with a tool such as Crontab.guru. See also the Cron Job & Cron Expressions Guide.

Details in CronJob troubleshooting.

Uploading a large file fails with "413 Request Entity Too Large" ​

Increase the Maximum file upload size for the website's PHP version. The Nginx limit is updated to match.

Long-running scripts are cut off or return 504 ​

Increase the Maximum execution time for the website's PHP version. For very long tasks (large imports, queue processing), run them as a cron job or daemon instead of through the browser.

Website shows 502 Bad Gateway ​

See 502 Bad Gateway error.

Code changed but the website still runs the old code ​

This is usually OPcache keeping the old code. Reload PHP-FPM as described in Restart PHP-FPM. If the website uses a cache plugin (for example in WordPress) or a CDN, clear the cache there too.