NGINX Unit

Walkthrough§

OK, so you’ve decided to give Unit a try with your web app of choice. You may be looking for ways to run it faster with less config overhead, streamlining your technology stack, or simply be tech-curious. In any case:

StepThings to do
Check the prerequisites
  1. Verify that Unit supports your platform and app language version.
  2. If possible, check how your app runs beside Unit to avoid confusion.
Get Unit in your system
  1. Install Unit with the language modules you need. Your options:
  2. Configure and launch Unit in your system:
    • Our own and third-party packages rely on systemctl or service.
    • Containerized Unit can be run with common docker commands.
    • If none of the above applies, customize Unit startup manually.
Prepare the app for Unit
  1. (Only applies to Go/Node.js) Patch your app to run in Unit.
  2. Choose common options such as app type, working directory, user/group.
  3. Add language-specific settings such as index, entry module, or executable.
Plug the app into Unit
  1. (Optional) Add Unit-wide settings to your app’s config to run it smoothly.
  2. Upload your config into Unit to spin up the app.
  3. (Optional) Set up a route to your app to benefit from internal routing.
  4. (Optional) Upload a certificate bundle if you want to support SSL/TLS.
  5. Finally, set up a listener to make your app publicly available.

For details of each step, see specific documentation sections.