---
name: "check-diskfree"
section: "8"
platform: "linux"
package: "checksecurity"
version: "2.0.18"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/check-diskfree"
---

# check-diskfree(8)

check for mounted filesystems nearing capacity

## NAME

check-free - check for mounted filesystems nearing capacity

## SYNOPSIS

**check-diskfree**

## DESCRIPTION

The **check-diskfree** is a plugin run by the **checksecurity** command. It scans mounted filesystems and allows alerts to be sent when  usage exceeds a given threshold. This is a plugin which is invoked by **checksecurity (8)** if enabled.

## CONFIGURATION

The **check-diskfree.conf** file defines the configuration variable: **CHECK\_DISK\_PERCENT** which is described below.

The  **CHECK\_DISK\_PERCENT** variable is the percentage full the filesystem must be before an alert is sent. Valid values are any numerical value between 1 and 100.

## FILES

- */etc/checksecurity.conf*

  Specifies whether this script is invoked

- */etc/checksecurity/check-diskfree.conf*

  The configuration file.