tangelo

tangelo [-h] [-c FILE] [-nc] [-a] [-na] [-p] [-np]
[–hostname HOSTNAME] [–port PORT] [-u USERNAME]
[-g GROUPNAME] [-r DIR] [–vtkpython FILE] [–verbose] [–quiet]
[–version] [–key FILE] [–cert FILE]

Start a Tangelo server.

Optional argument Effect
-h, –help show this help message and exit
-c FILE, –config FILE specifies configuration file or json string to use
-nc, –no-config skips looking for and using a configuration file
-a, –access-auth enable HTTP authentication (i.e. processing of .htaccess files) (default)
-na, –no-access-auth disable HTTP authentication (i.e. processing of .htaccess files)
-p, –drop-privileges enable privilege drop when started as superuser (default)
-np, –no-drop-privileges disable privilege drop when started as superuser
-s, –sessions enable server-side session tracking (default)
-ns, –no-drop-privileges disable server-side session tracking
–hostname HOSTNAME overrides configured hostname on which to run Tangelo
–port PORT overrides configured port number on which to run Tangelo
-u USERNAME, –user USERNAME specifies the user to run as when root privileges are dropped
-g GROUPNAME, –group GROUPNAME specifies the group to run as when root privileges are dropped
-r DIR, –root DIR the directory from which Tangelo will serve content
–examples serve the Tangelo example applications
–verbose, -v display extra information as Tangelo runs
–quiet, -q reduce the amount of information displayed
–version display Tangelo version number
–key FILE the path to the SSL key. You must also specify –cert to serve content over https.
–cert FILE the path to the SSL certificate. You must also specify –key to serve content over https.

Example Usage

To start a Tangelo server with the default configuration, serving from the current directory:

tangelo

This starts Tangelo on port 8080.

To serve the example applications that come bundled with Tangelo:

tangelo --examples

To control particular options, such as the port number (overriding the value specified in the config) file:

tangelo --port 9090