[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

[Knowledge base](/kb/)[Linux](/kb/linux/)Clean Up Stale nginx Unix Sockets with a systemd Drop-in

Search the knowledge basePress/

ESC

Jump to

[Browse the knowledge base](/kb/)[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

↵select↑↓navigateescclose

Search the knowledge base

[Skip to the article](#kb-article)[Linux](/kb/linux/)9 articles

- [Overview](/kb/linux/)
- [Clean Up Stale nginx Unix Sockets with a systemd Drop-in](/kb/linux/nginx-socket-cleanup-drop-in/)
- [Intel GPU Kernel Parameters](/kb/linux/intel-gpu-kernel-parameters/)
- [Media Conversion Recipes](/kb/linux/media-conversion-recipes/)
- [Mount a Drive with a systemd Mount Unit](/kb/linux/systemd-mount-units/)
- [Release Stuck Messages in the Postal Mail Server Queue](/kb/linux/postal-release-queued-messages/)
- [Set Up a WireGuard VPN Host](/kb/linux/wireguard-host-setup/)
- [Shell One-Liners](/kb/linux/shell-one-liners/)
- [Swap Configuration](/kb/linux/swap-configuration/)
- [Switch Commands with update-alternatives and sudo-rs](/kb/linux/sudo-rs-and-update-alternatives/)

Other sections[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

In Linux: 9 articles

[Overview](/kb/linux/)[Clean Up Stale nginx Unix Sockets with a systemd Drop-in](/kb/linux/nginx-socket-cleanup-drop-in/)[Intel GPU Kernel Parameters](/kb/linux/intel-gpu-kernel-parameters/)[Media Conversion Recipes](/kb/linux/media-conversion-recipes/)[Mount a Drive with a systemd Mount Unit](/kb/linux/systemd-mount-units/)[Release Stuck Messages in the Postal Mail Server Queue](/kb/linux/postal-release-queued-messages/)[Set Up a WireGuard VPN Host](/kb/linux/wireguard-host-setup/)[Shell One-Liners](/kb/linux/shell-one-liners/)[Swap Configuration](/kb/linux/swap-configuration/)[Switch Commands with update-alternatives and sudo-rs](/kb/linux/sudo-rs-and-update-alternatives/)

Other sections[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

LinuxClean Up Stale nginx Unix Sockets with a systemd Drop-in

Add a systemd drop-in that removes leftover Unix socket files before nginx starts, so it doesn't fail with Address already in use.

UpdatedOct 1, 2026

Applies toUbuntu 24.04systemd 255nginx 1.24

Tagsnginxsystemdubuntu

Reading time3 min

On this page[Add the Drop-in](#add-the-drop-in)[Alternative: Let systemd Manage the Directory](#alternative-let-systemd-manage-the-directory)

When nginx listens on Unix sockets (for example `listen unix:/run/nginx-sockets/site.sock;` behind a load balancer or another proxy), it normally removes the socket files when it shuts down cleanly. After a crash, a `kill -9`, or a power loss, the files stay behind, and the next start fails:

```text
nginx: [emerg] bind() to unix:/run/nginx-sockets/site.sock failed (98: Address already in use)
```

A systemd drop-in can delete stale sockets every time the service starts.

## Add the Drop-in

Keep nginx's sockets in a directory used only by nginx, such as `/run/nginx-sockets`, so the cleanup can't touch another service's sockets (PHP-FPM, for example).

Create the drop-in with `systemctl edit`, which opens an editor and saves the file to `/etc/systemd/system/nginx.service.d/override.conf`:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">systemctl</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">edit</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">nginx</span>
```

Add:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">[Service]</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">ExecStartPre</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">=/bin/sh -c </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'rm -f /run/nginx-sockets/*.sock'</span>
```

Or write the file directly:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">mkdir</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-p</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">/etc/systemd/system/nginx.service.d</span>
<span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">printf</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'%s\n'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'[Service]'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"ExecStartPre=/bin/sh -c 'rm -f /run/nginx-sockets/*.sock'"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">/etc/systemd/system/nginx.service.d/rm-sock.conf</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">systemctl</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">daemon-reload</span>
```

Restart nginx and confirm the drop-in is loaded:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">systemctl</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">restart</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">nginx</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">systemctl</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">cat</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">nginx</span>
```

The command runs through `/bin/sh` because systemd doesn't expand wildcards like `*.sock` itself. Drop-in `ExecStartPre` lines run after the ones in the main unit, so Ubuntu's built-in `nginx -t` config test still runs first.

Note

Put drop-ins under `/etc/systemd/system/`, not `/lib/systemd/system/` or `/usr/lib/systemd/system/`. Files in those directories belong to packages and can be overwritten on upgrade.

## Alternative: Let systemd Manage the Directory

If the socket directory lives under `/run`, systemd can create it at start and delete it, with everything inside, at stop:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">[Service]</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">RuntimeDirectory</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">=nginx-sockets</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">RuntimeDirectoryMode</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">=0755</span>
```

systemd removes the directory whenever the service stops, including when it fails or is killed, and `/run` is cleared on reboot, so stale sockets can't survive. Use this or the `ExecStartPre` cleanup, not both: `RuntimeDirectory` deletes the directory on stop, so nothing else should store files in it.

Sources

- [www.freedesktop.org/software/systemd/man/latest/systemd.unit.html](https://www.freedesktop.org/software/systemd/man/latest/systemd.unit.html)
- [www.freedesktop.org/software/systemd/man/latest/systemd.service.html](https://www.freedesktop.org/software/systemd/man/latest/systemd.service.html)
- [nginx.org/en/docs/http/ngx_http_core_module.html#listen](https://nginx.org/en/docs/http/ngx_http_core_module.html#listen)

Need help with Linux servers?

Our notes can take you a long way, but sometimes you'd rather have someone who's done it before.

[Managed infrastructure](/services/infrastructure/)

[← PreviousOverview](/kb/linux/)[Next →Intel GPU Kernel Parameters](/kb/linux/intel-gpu-kernel-parameters/)

CC0This article is in the public domain ([CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)), code samples included. Use it however helps you.

On this page

- [Add the Drop-in](#add-the-drop-in)
- [Alternative: Let systemd Manage the Directory](#alternative-let-systemd-manage-the-directory)

[Back to top↑](#top)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
