+0
Daily
5,534
stars
383
forks
5
watchers
467
prs
1,089
issues
5
releases
README
NGINX Unit
Note: This repository has been archived. There will likely be no further development at this repo, and security vulnerabilities may be unaddressed.
The repo may be cloned and used under its current license.
Universal Web App Server
!NGINX Unit Logo
NGINX Unit is a lightweight and versatile open-source server that has
two primary capabilities:
- serves static media assets,
- runs application code in eight languages.
Unit compresses several layers of the modern application stack into a potent,
coherent solution with a focus on performance, low latency, and scalability. It
is intended as a universal building block for any web architecture, regardless
of its complexity, from enterprise-scale deployments to your pet's homepage.
Its native RESTful JSON API enables dynamic
updates with zero interruptions and flexible configuration, while its
out-of-the-box productivity reliably scales to production-grade workloads. We
achieve that with a complex, asynchronous, multithreading architecture
comprising multiple processes to ensure security and robustness while getting
the most out of today's computing platforms.
Installation
macOS
Run the following command to install both unitd (the Unit daemon) and
unitctl (the control tool).
console
$ brew install nginx/unit/unit
For details and available language packages, see the
docs.
Docker
console
$ docker pull unit:
$ mkdir /tmp/unit-control customize as needed.
$ docker run -d \
--mount type=bind,src=/tmp/unit-control,dst=/var/run \
--mount type=bind,src=.,dst=/www \
--network host \
unit
For a description of image tags, see the
docs.
WARNING: The latest image tag may not provide support for specific languages
modules, do check the available image tags from the link above before
pulling your image.
Your current working directory will now be mounted to the Unit image at /www.
You can reach its socket at /tmp/unit-control/control.unit.sock assuming no
further customizations have been made.
Debian, Ubuntu, Amazon Linux, Fedora, Red Hat
This helper script configures the correct package repositories for system.
console
$ wget https://raw.githubusercontent.com/nginx/unit/master/tools/setup-unit && chmod +x setup-unit
./setup-unit repo-config
Debian derivatives:
console
apt install unit
Fedora derivatives:
console
yum install unit
For details and available language packages, see the
docs.
Getting Started with unitctl
unitctl streamlines the management of NGINX Unit processes
through an easy-to-use command line interface. To get started with unitctl,
download it from the
official GitHub releases
or Homebrew.
Installation
[!NOTE]
If you installed Unit with Homebrew, you can skip this step
as unitctl is included by default.
Download the appropriate unitctl binary for your system from the
NGINX Unit releases.
console
$ tar xzvf unitctl-master-x86_64-unknown-linux-gnu.tar.gz
mv unitctl /usr/local/bin/
Launch Unit using Docker
If yTop issues
#794The last versions of Nginx Unit fails in the TechEmpower benchmark49 comments · 2022-11-29#1606signal 11 (core dumped) 3 mins after making a call42 comments · 2025-05-01#795Undefined Behavior: write past the end of an array26 comments · 2022-11-30#788"uidmap" field has no "container" entry for user "demo1" (uid 1001)24 comments · 2022-11-20#516ModuleNotFoundError: No module named 'encodings'23 comments · 2020-12-31#408Not terminated php process after timeout21 comments · 2020-03-11#388HTTP/2 support21 comments · 2020-02-06#1576unit:1.34.1-php8.4 consumes more and more memory over time (possibly due to one unitd process)20 comments · 2025-03-17
Discussions
#1668Mutual authentication0 comments · 2025-10-08#1662snapcraft.io0 comments · 2025-10-04#1645How often the containers are updated?0 comments · 2025-08-29#1633How soon can we expect debian trixie builds?0 comments · 2025-08-12#1627cross-build nginx-unit with yocto/bitbake0 comments · 2025-06-25#1625Config.json setting for simplesamlphp2 comments · 2025-06-21#1618[OpenRun] AppServer which runs apps in containers0 comments · 2025-05-21#1605State of Unit going forward0 comments · 2025-04-30
Latest release
1.35.0 1.35.0 2025-09-11Unitctl This is a released binary of unitctl. Unitctl is an official command line tool for managing Unit installations. Unit For the current release of the NGINX Unit application server check the Unit Installation Guide and the Unit Quickstart Guide.