Can't remember where, but I read uWSGI can reload itself like Django development server when a project script is modified. I can't find that in the docs, nor in the internets. How can I do this?

I use Ubuntu 12.04 on my working machines and Debian Squeeze on stage & production server, Django 1.4 and uWSGI 1.2.

5 Answers 5


Reference: http://projects.unbit.it/uwsgi/wiki/Management

If you have started uwsgi with the --touch-reload=/path/to/special/file/usually/the.ini option, reloading your uWSGI is a simple matter of touch reloading that file with

touch /path/to/special/file/usually/the.ini

And if you want the "autoreload" capability, this is the tip that gets this done: http://projects.unbit.it/uwsgi/wiki/TipsAndTricks#uWSGIdjangoautoreloadmode


There is a py-autoreload=N option in newer releases. Just set N to the frequency (in seconds) of checks (3 is a good value).


If you don't want lose the django autoreload, register this reload method (i.e: in settings.py):

import uwsgi
from uwsgidecorators import timer
from django.utils import autoreload

def change_code_gracefull_reload(sig):
    if autoreload.code_changed():

Now if you change your code it will be reloaded.

Author: Simone Federici

  • 1
    This worked perfectly. Also added a conditional so this only gets called in the development environment.
    – 2upmedia
    Sep 23, 2015 at 18:01
  • autoreload.code_changed no longer exists. what should we use in 2021?
    – Jayen
    Aug 1, 2021 at 11:16

uwsgi also allow restart using kill SIGNAL. I use it as below:

# ps -efa | grep uwsgi | grep prod
app  13390 13383  0 07:40 ?        00:00:00 /usr/local/bin/uwsgi --ini /etc/uwsgi/apps-enabled/app_prod.ini
app  13417 13390  0 07:40 ?        00:00:00 /usr/local/bin/uwsgi --ini /etc/uwsgi/apps-enabled/app_prod.ini
app  13419 13390  0 07:40 ?        00:00:00 /usr/local/bin/uwsgi --ini /etc/uwsgi/apps-enabled/app_prod.ini
# kill -HUP 13390

If you run same command, you will see child procs pid will be changed as they are re-spawned by master. Also check uwsgi config for master/worker proc counts. This method is easy to integrate with ansible or other automation tools so goes easy to for remote use.

This doesn't need your original proc to be started with --touch-reload.


As stated in docs to make uWSGI gracefully restart.

# using kill to send the signal
kill -HUP `cat /tmp/project-master.pid`
# or the convenience option --reload
uwsgi --reload /tmp/project-master.pid
# or if uwsgi was started with touch-reload=/tmp/somefile
touch /tmp/somefile

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.