unitd - 'runs the NGINX Unit daemon'

---

unitd(8) System Manager’s Manual unitd(8)

Name

unitd — runs the NGINX Unit daemon

Synopsis

unitd [−−no-daemon] [−−control socket] [−−control-mode mode] [−−control-user user] [−−control-group group] [−−group name] [−−user name] [−−log file] [−−modulesdir directory] [−−pid file] [−−statedir directory]
unitd [−h | −−help | −−version]

Description

NGINX Unit is a polyglot app server, a reverse proxy, and a static file server for UNIX-like systems. It was built by nginx(8) team members from scratch to be highly efficient and fully configurable at runtime.

Options
−h, −−help

Displays a summary of Unit’s command-line options and their compile-time defaults.

−−version

Displays Unit’s version and the ./configure settings it was built with.

−−no-daemon

Runs Unit in non-daemon mode.

−−control socket

Overrides the control API’s socket address in IPv4, IPv6, or UNIX-domain format.

−−control-mode mode

Sets the permission of the UNIX-domain control socket.

−−control-user user

Sets the owner of the UNIX-domain control socket.

−−control-group group

Sets the group of the UNIX-domain control socket.

−−group name, −−user name

Override group name and user name used to run Unit’s non-privileged processes.

−−log file

Overrides the pathname for Unit’s log.

−−modulesdir directory

Overrides the directory path for Unit’s language modules (

*.unit.so ) files.

−−pid file

Overrides the pathname for the PID file of Unit’s main process.

−−statedir directory

Overrides the directory path for Unit’s state storage.

Exit status

Exit status is 0 on success, or 1 if the daemon encounters an error.

Files
/run/unit.pid

The PID file of Unit’s main process.

/var/log/unit.log

A general-purpose log for diagnostics and troubleshooting.

Sockets
unix:/run/control.unit.sock

The socket address of Unit’s control API.

Copyright

(C) 2017-2025 NGINX, Inc.
(C) 2017-2025 Andrei Zeliankou
(C) 2018-2025 Konstantin Pavlov
(C) 2021-2025 Zhidao Hong
(C) 2022-2025 Andrew Clayton
(C) 2022-2025 Liam Crilly
(C) 2023-2025 Dan Callahan
(C) 2023-2025 Igor Ippolitov
(C) 2024-2025 Ava Hahn
(C) 2023-2024 Danielle De Leo
(C) 2023-2024 Dylan Arbour
(C) 2023-2024 Gabor Javorszky
(C) 2023-2024 Taryn Musgrave
(C) 2021-2023 Alejandro Colomar
(C) 2017-2022 Valentin V. Bartenev
(C) 2017-2022 Max Romanov
(C) 2021-2022 OisÃn Canty
(C) 2017-2021 Igor Sysoev
(C) 2017-2021 Andrei Belov
(C) 2019-2021 Tiago Natel de Moura
(C) 2019-2020 Axel Duch
(C) 2018-2019 Alexander Borisov

SPDX-License-Identifier: Apache-2.0

See also

Website: https://unit.nginx.org

User mailing list: https://mailman.nginx.org/mailman/listinfo/unit

GitHub: https://github.com/nginx/unit NGINX Unit 2023-04-26 unitd(8)

---