Skip to content

[1.18] SIGHUP documentation #5064

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JoshVanL wants to merge 2 commits into
base: v1.18
Choose a base branch
from
+26 −1
Open

[1.18] SIGHUP documentation #5064

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5e48a7c
SIGHUP documentation
JoshVanL Mar 9, 2026
b192250
Code review
JoshVanL Mar 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions daprdocs/content/en/operations/components/component-updates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ When running in Kubernetes, the process of updating a component involves two ste

Unless the [`HotReload` feature gate is enabled](#hot-reloading-preview-feature), the process of updating a component involves a single step of stopping and restarting the `daprd` process to pick up the latest component.

> **Note:** On POSIX-compatible systems (Linux, macOS), you can also send a `SIGHUP` signal to the `daprd` process to reload the runtime in-process without fully restarting it. See [Reloading configuration with SIGHUP]({{% ref "configuration-overview.md#reloading-configuration-with-sighup" %}}) for more information.

## Hot Reloading (Preview Feature)

> This feature is currently in [preview]({{% ref "preview-features.md" %}}).
Expand Down
25 changes: 24 additions & 1 deletion daprdocs/content/en/operations/configuration/configuration-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ The following menu includes all of the configuration settings you can set:
- [Disallow usage of certain component types](#disallow-usage-of-certain-component-types)
- [Turning on preview features](#turning-on-preview-features)
- [Example sidecar configuration](#example-sidecar-configuration)
- [Reloading configuration with SIGHUP](#reloading-configuration-with-sighup)

#### Tracing

Expand Down Expand Up @@ -380,9 +381,31 @@ spec:
action: allow
```

## Reloading configuration with SIGHUP

On POSIX-compatible systems (Linux, macOS), you can reload the Dapr sidecar configuration without fully restarting the process by sending a `SIGHUP` signal to `daprd`. When `daprd` receives a `SIGHUP`, it gracefully shuts down the internal runtime and re-initializes it in-process using the current configuration file. This allows you to apply changes to configuration settings such as [tracing](#tracing), [metrics](#metrics), and [logging](#logging) without downtime.

To send a `SIGHUP` signal:

```bash
# Using the kill command
kill -SIGHUP <daprd-pid>

# Or using pkill
pkill -HUP daprd
```

{{% alert title="Note" color="primary" %}}
During a SIGHUP reload, the Dapr sidecar is briefly unavailable while the runtime reinitializes. The sidecar will continue to handle graceful shutdown of existing connections before reloading.
{{% /alert %}}

{{% alert title="Note" color="primary" %}}
SIGHUP-based reloading is only available on POSIX-compatible systems (Linux, macOS). On Windows, a full restart of `daprd` is required to pick up configuration changes.
{{% /alert %}}

## Control plane configuration

A single configuration file called `daprsystem` is installed with the Dapr control plane system services that applies global settings.
A single configuration file called `daprsystem` is installed with the Dapr control plane system services that applies global settings.

> **This is only set up when Dapr is deployed to Kubernetes.**

Expand Down
Loading