---
name: "calendarserver_purge_principals"
section: "8"
platform: "linux"
package: "calendarserver"
version: "9.2+dfsg-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/calendarserver_purge_principals"
---

# calendarserver\_purge\_principals(8)

Calendar Server deprovisioned user clean-up utility

## NAME

**calendarserver\_purge\_principals** – Calendar Server deprovisioned user clean-up utility

## SYNOPSIS

**calendarserver\_purge\_principals** \[**--completely**\] \[**--config** *file*\] \[**--dry-run**\] \[**--verbose**\] \[**--help**\] *guid* \[guid ...\]

## DESCRIPTION

**calendarserver\_purge\_principals** is a tool for removing one or more principals' future events, proxy assignments, and contacts from the calendar server.  By default, events in the past are retained, but any ongoing events are canceled.

**calendarserver\_purge\_principals** should be run as a user with the same privileges as the Calendar Server itself, as it needs to read and write data that belongs to the server.

## OPTIONS

- **-h,** **--help**

  Display usage information

- **-c,** **--completely**

  Delete/cancel all events

- **-f,** **--config** *FILE*

  Use the Calendar Server configuration specified in the given file. Defaults to /etc/caldavd/caldavd.plist.

- **-n,** **--dry-run**

  Calculate and display how many events and contacts would be removed, but don't actually remove them.

- **-v,** **--verbose**

  Print progress information.

## FILES

- /etc/caldavd/caldavd.plist

  The Calendar Server configuration file.

## SEE ALSO

[caldavd(8)](/caldavd/8.md)