3 Catalyst::Manual::Deployment::NGINXUnit::PSGI - Deploying Catalyst with NGINX Unit
7 Catalyst runs under L<NGINX Unit|https://unit.nginx.org> using PSGI.
11 To configure a Catalyst app in NGINX Unit, upload a JSON configuration
12 snippet via Unit's config API, available at an IP socket or a Unix domain
13 socket (depending on Unit's L<startup settings|
14 https://unit.nginx.org/installation/#installation-startup>):
16 # curl -X PUT --data-binary @config.json --unix-socket \
17 /path/to/control.unit.sock http://localhost/config
19 A minimal L<configuration|https://unit.nginx.org/configuration/#perl>
20 includes a listener and an application entity:
25 "pass": "applications/catalyst_app"
32 "script": "/path/to/apps/myapp/myapp.psgi",
33 "user": "catalyst_user",
34 "group": "catalyst_group"
39 The C<script> should point to your app's C<.psgi> file; C<user> and
40 C<group> should have appropriate access rights.
42 After a successful reconfiguration, you can manage your Catalyst
43 app via the same L<config API|
44 https://unit.nginx.org/configuration/#applications>.
48 Note: make sure the app's C<.psgi> file includes the C<lib/>
58 For more information on NGINX Unit, visit: L<http://unit.nginx.org>
62 Catalyst Contributors, see Catalyst.pm
66 This library is free software. You can redistribute it and/or modify it under
67 the same terms as Perl itself.