---
name: "psi-notify"
section: "1"
platform: "linux"
package: "psi-notify"
version: "1.3.1-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/psi-notify"
---

# psi-notify(1)

notify on system-wide resource pressure using PSI

## NAME

psi-notify - notify on system-wide resource pressure using PSI

## DESCRIPTION

**psi-notify** is a minimal unprivileged notifier for system-wide resource pressure using PSI. This can help you to identify misbehaving applications on your machine before they start to severely impact system responsiveness, in a way which *MemAvailable*, CPU graphs, I/O utilisation graphs and other metrics cannot.

## OPTIONS

**psi-notify** does not take any options. If any are provided, a help message will be printed and **psi-notify** will exit.

## CONFIGURATION

You can optionally put configuration in *~/.config/psi-notify*. Here's an example that will check roughly every 5 seconds, and pop up a notification when the configured values are exceeded:

```
update 5
log_pressures false
threshold cpu some avg10 50.00
threshold memory some avg10 10.00
threshold io full avg10 15.00
```

These are the default settings if no configuration is provided.

For more information about how these values are calculated, please see the PSI documentation at ⟨https://facebookmicrosites.github.io/psi/⟩.

## DEPENDENCIES

**psi-notify** requires Linux kernel 4.20+ and **CONFIG\_PSI=y**. You will also need a notification daemon that conforms to the Desktop Notifications specification to receive the notifications.

## SEE ALSO

**cgroups**(8), [**proc**(5)](/proc/5.md)

## AUTHOR

Chris Down ⟨chris@chrisdown.name⟩

## REPORTING BUGS

Please send bug reports to ⟨https://github.com/cdown/psi-notify/issues⟩.
