Your Background Process Keeps Dying After Shell Exit? Stop Blaming nohup — Understand setsid and Unix Process Lifecycle

Mon, 01 Jun 2026 07:00:00 +0800

The short version

You launched a background service. You used nohup. You added &. You redirected output. Everything looked fine. But when you closed the terminal, disconnected SSH, or—more insidiously—when an automation tool finished executing its script, the process silently vanished. You checked ps—nothing. You checked the port—nothing. No error in the logs. If this has happened to you, you’re not alone.

The root cause isn’t SIGHUP—at least, not entirely. The real issue is process group and session membership. nohup merely tells the process to ignore the SIGHUP signal, but the process still belongs to the same session and process group as the parent shell. When the shell exits and sends SIGHUP to the entire process group, nohup helps—but only if the signal delivery chain stops there. If the controlling terminal is destroyed, if stdin/stdout pipes break, or if the parent’s process group is collectively reaped, the process can still die. The proper fix is setsid: it creates a brand-new session, detaches from the controlling terminal, and places the process in its own process group—so SIGHUP from the parent shell never reaches it in the first place.

This post is based on a real debugging session of the CLIProxyAPI service. The service was started with nohup but kept disappearing every time an automation script finished. The management panel kept showing “connection failed.” The culprit turned out to be a subtle Unix process lifecycle issue. This class of problem is common in cloud dev machines, CI runners, SSH jump hosts, and containerized workflows, but it’s often misdiagnosed because the underlying process model is poorly understood.

All private details have been removed. No real internal addresses, tokens, or paths appear in this article.

Process Management on Margrop Blog

Your Background Process Keeps Dying After Shell Exit? Stop Blaming nohup — Understand setsid and Unix Process Lifecycle