ScaleScaleScaleScale

Tips / Nginx


How to Fix 504 Gateway Timeout using Nginx


It is very common to see a 504 Gateway Timeout error using Nginx webserver. This timeout error is generated often by a number of reasons on the backend connection that is serving content. To fix 504 Gateway Time-out, you will have to figure out what configuration are you using.

How you might see the 504 Gateway Timeout error

Different websites may customize the 504 gateway timeout error message. Here are the most common 504 error messages:

  • “504 Gateway Timeout”
  • “504 Gateway Time-Out”
  • “504 Gateway Timeout NGINX”
  • “Nginx 504 Gateway Timeout”
  • “HTTP 504 Gateway Timeout”
  • “HTTP 504 Error”
  • “HTTP 504”
  • “Gateway Timeout (504)”

504 Gateway Timeout error on Nginx + FastCGI (php-fpm)

For Nginx + FastCGI (php-fpm), you should try to tweak nginx configuration in this way:

Try raising max_execution_time setting in php.ini file (CentOS path is /etc/php.ini):

max_execution_time = 300

But, you should also change set request_terminate_timeout parameter (commented by default) at www.conf file from PHP-FPM:

pico -w /etc/php-fpm.d/www.conf

Then set the variable to the same value as max_execution_time:

request_terminate_timeout = 300

Now let’s add fastcgi_read_timeout variable inside our Nginx virtual host configuration:

location ~ .php$ {
root /var/www/sites/nginxtips.com;
try_files $uri =404;
fastcgi_pass unix:/tmp/php5-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_read_timeout 300;
}

Then restart nginx:

service nginx reload

504 Gateway Timeout error using Nginx as Proxy

For Nginx as Proxy for Apache web server, this is what you have to try to fix the 504 Gateway Timeout error:

Add these variables to nginx.conf file:

  proxy_connect_timeout       600;
  proxy_send_timeout          600;
  proxy_read_timeout          600;
  send_timeout                600;

Then restart nginx:

service nginx reload

Additional Resources

Popular search terms:

  • 504 gateway timeout nginx
  • 504 gateway time-out nginx
  • https://www scalescale com/tips/nginx/504-gateway-time-out-using-nginx/
  • nginx gateway timeout
profile

Esteban Borges

Linux Geek, Webperf Addict, Nginx Fan. CTO @Infranetworking

  • http://www.rapidpricecomparison.com/ mert_can2

    Hello,

    I have linux server and I am getting this “504 Gateway Time-out” error on my website. Actually I am Windows user and I am not understanding linux. I can’t fix it this error. Could you write more detail please how can I do that?

    Thanks

  • Pablo

    Thank you very much! I was having this issue and your post was exactly what I needed to fix this 😉

  • Suman Kar

    Solution worked like a magic…thanks

  • NicoVS

    Nice info…
    Just a little tip: service nginx reload should be sufficient. This way you will not abruptly disconnect your clients

  • admin

    You are right on that NicoVS. Fixed.

    • http://www.firstscribe.com Darren Felton

      Just a note, you updated “service nginx reload” on the “For nginx as Proxy” section, but not the FastCGI section of your article.

      • admin

        Fixed, thanks!

  • http://strmur.com Lupoo

    Do you have to set
    proxy_connect_timeout 600;

    from nginx docs
    http://wiki.nginx.org/HttpProxyModule#proxy_connect_timeout

    “This directive assigns a timeout for the connection to the upstream server. It is necessary to keep in mind that this time out cannot be more than 75 seconds. ”

    So the upper bound is 75 no?

  • admin

    Haven’t seen any issues setting the value to more than 75.

  • Stefan

    Thank you for posting this, it was very helpful!

  • http://infosecur.pl Michal

    Thank you for usefull information, It’s help me to right configure Nginx Server on Ubuntu. And now Nginx works great:-)

  • shadownet

    Don’t forget to restart php also:
    service php5-fpm reload

    (not working otherwise for me)

  • http://cartirecomandate.com/ Joseph

    Hey there!

    Is there a way to prevent this timeout if I do not have access to the php.ini file? Maybe from the php file or .htaccess?

    Thanks!

  • http://drmikessteakdinner.com Dr. Mike Wendell

    Thanks for this. May I make the suggestion though of covering where the Nginx virtual host configuration file is normally? I know everybody’s install is usually different but gotta admit that it took me a few minutes to remember where mine was. For me, it was in the /etc/nginx/sites-available directory.

    • admin

      Mike

      You mentioned ‘normally’, but what is normal to you using /etc/nginx/sites-available (usually on Debian/Ubuntu) is not normal for RHEL based users like Fedora, CentOS and RHEL itself. And it’s also different when you build nginx from the source gz files. It’s impossible to cover all posible nginx directory installations.

      Thanks for your comment.

  • annoyed

    it’s sad that this is the top search result for “nginx timeout 504″…i guess the ONLY way to use nginx is with PHP…otherwise “you will have to figure out what configuration are you using”. WTF. useless.

  • http://www.linxmanager.com Sandy Keathley

    Did not work for me. Got this error:
    “proxy_connect_timeout” directive is not allowed here in /etc/nginx/nginx.conf:10

    None of those commands were allowed.

  • http://www.hitmaroc.net/ Jandy

    Does anyone know how to set “fastcgi_read_timeout” to never timeout? I set it to 0 (zero) and it will display “service unavailable”. Thanks.

    • http://www.nginxtips.com Esteban Borges

      Try setting it to a very high value, example 1 hour or 1 day:

      Good luck.

  • http://transparent-uk.com Alexander

    Thanks for that, worked like a charm!

  • Shreya Mahajan

    i didn’t get nginx directory in etc
    please let me know as soon as possible,thanks in advance

  • Abraham Tugalov

    Works fine.