root@dev-demo-karl:/srv/www# supervisord -v

Trying to get supervisorctl working:

root@dev-demo-karl:/srv/www# supervisorctl
http://localhost:9001 refused connection

My config:



4 Answers 4


Apparently there are required fields for the configuration file for version 3.0 and upwards http://supervisord.org/configuration.html

[inet_http_server] is required:

A TCP host:port value or (e.g. on which supervisor will listen for HTTP/XML-RPC requests. supervisorctl will use XML-RPC to communicate with supervisord over this port. To listen on all interfaces in the machine, use :9001 or *:9001.

Default: No default.

Required: Yes.

Introduced: 3.0

Also [rpcinterface:supervisor] is required as it complains.

So my configuration must look like so:



port =

supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

Now it connects.

  • Thanks so much, I was getting mad of that error, but your answer really helped me :)
    – a3k
    Nov 20, 2021 at 3:10

Be sure to check the following if you get the http://localhost:9001 refused connection error.

  1. Make sure supervisord is running
  2. Have these enabled (uncommented) in supervisord.conf file:





    supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

Note: The host and port of the inet server and the one which supervisorctl is trying to connect to should be the same.


At first You should start supervisord with -c flag and point the cfg file.

sudo supervisord -c /path/to/config/file

after that run supervisorctl

Try to run supervisord with sudo to make sure this is not premission issue. If everything works right You may start the app without the sudo.

-c flag may be needed with supervisorctl as well if I remember correct, but I'm not sure its necessary.


By Default inet_http_server is turned off in supervisor config. You need to enable if if exist or add the following lines if it doesn't

[inet_http_server] port =

Then restart Supervisord; You should be all set sudo supervisorctl status should show processes with corresponding statuses

  • Nothing new compared to the accepted error
    – Félicien
    Feb 28, 2018 at 14:29

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

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