Fix 504 Errors with OctoberCMS on Laravel Homestead

504 Error Installing OctoberCMS

Sometimes installing OctoberCMS using the wizard, or updating the system on a Laravel Homestead VM doesn’t work out of the box with nginx. There’s a default setting (of nginx) that caused me some problems initially, here’s how to fix it.

The solution

  1. SSH into your virtual machine. I use the nice vm alias described here.

  2. Edit the /etc/nginx/nginx.conf file

    Add this line to the http section:

    You may need to increase the timeout, but 300 worked for me.

  3. Restart nginx

Now the install wizard and system / plugin updates for OctoberCMS should work correctly on the Homestead VM!

Here’s a snippet of what the changed nginx.conf file should look like:

Comments & Questions