[inet_http_server] Section Settings

The supervisord.conf file contains a section named[inet_http_server] under which configuration parameters for anHTTP server that listens on a TCP (internet) socket should beinserted. If the configuration file has no [inet_http_server]section, an inet HTTP server will not be started. The allowableconfiguration values are as follows.

Warning

The inet HTTP server is not enabled by default. If you choose to enable it,please read the following security warning. The inet HTTP server is intendedfor use within a trusted environment only. It should only be bound to localhostor only accessible from within an isolated, trusted network. The inet HTTP serverdoes not support any form of encryption. The inet HTTP server does not useauthentication by default (see the username= and password= options).The inet HTTP server can be controlled remotely from supervisorctl.It also serves a web interface that allows subprocesses to be started or stopped,and subprocess logs to be viewed. Never expose the inet HTTP server to thepublic internet.

[inet_http_server] Section Values

port

A TCP host:port value or (e.g. 127.0.0.1:9001) on whichsupervisor will listen for HTTP/XML-RPC requests.supervisorctl will use XML-RPC to communicate withsupervisord over this port. To listen on all interfacesin the machine, use :9001 or *:9001. Please read the securitywarning above.

Default: No default.

Required: Yes.

Introduced: 3.0

username

The username required for authentication to this HTTP server.

Default: No username required.

Required: No.

Introduced: 3.0

password

The password required for authentication to this HTTP server. Thiscan be a cleartext password, or can be specified as a SHA-1 hash ifprefixed by the string {SHA}. For example,{SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d is the SHA-storedversion of the password “thepassword”.

Note that hashed password must be in hex format.

Default: No password required.

Required: No.

Introduced: 3.0

[inet_http_server] Section Example

[inet_http_server]
port = 127.0.0.1:9001
username = user
password = 123