housekeeping script to clean up Prosodys env and Database
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Codacy Badge

Prosody housekeeping

This script is designed to fight of unnecessary database space and junk.


  • Prosody Server
  • Prosody Community Modules listed in the main config file or in the path
  • shell access

How to install

Edit the script to fit your timeframes and paths. Add the cerdentials of your prosodys database users to the file and enable mod_mam clearing. Start daily with cron or place script as .sh file in the "cron.daily" anacron directory.

Work Flow

  • Filter registered but never logged in accounts
  • Filter formerly used but now unused accounts
  • if enabled delete expired mod_mam entries
  • delete all filtered users

Ignore List

Feature to ignore defined user accounts by placing the full JID in the ignore file one per line. There is no need to take care of whitespaces or emtpy lines. The Skript will automatically prepare the list and remove excess whitespaces/empty lines. It is possible to ignore both unused registered accounts and old accounts. It is not possible to specify an ignore list for each filter. There is only a generel ignore file.