Configuration¶

To configure a Catalyst app in NGINX Unit, upload a JSON configuration snippet via Unit's config API, available at an IP socket or a Unix domain socket (depending on Unit's startup settings):

    # curl -X PUT --data-binary @config.json --unix-socket \
       /path/to/control.unit.sock http://localhost/config

A minimal configuration <https://unit.nginx.org/configuration/#perl> includes a listener and an application entity:

    {
        "listeners": {
            "127.0.0.1:8080": {
                "pass": "applications/catalyst_app"
            }
        },
        "applications": {
            "catalyst_app": {
                "type": "perl",
                "script": "/path/to/apps/myapp/myapp.psgi",
                "user": "catalyst_user",
                "group": "catalyst_group"
            }
        }
    }

The "script" should point to your app's ".psgi" file; "user" and "group" should have appropriate access rights.

After a successful reconfiguration, you can manage your Catalyst app via the same config API.

    use lib 'lib';
    use myapp;