MX-CLEANUP(1)

NAME
mx-cleanup - GUI for disk cleanup and system maintenance on MX Linux

SYNOPSIS
mx-cleanup [options]

DESCRIPTION
mx-cleanup is a graphical application that offers several easy actions to check and increase hard drive space. It can safely remove old and unnecessary files and clear logs through a user-friendly interface.

Available cleanup categories include:

Folders
    User cache and thumbnail cache.

Apt (Installation)
    Package cache cleanup and purging of residual configuration left behind by removed packages. "Old files" removes package archives that can no longer be downloaded again; "All files" empties the cache completely.

Logs
    System logs under /var/log. "Old logs" removes rotated logs ending in .gz, .old, and .1; "All logs" truncates every log file to empty instead.

Trash
    The desktop trash can, for the selected user or for all users.

Flatpak
    Unused Flatpak runtimes.

Cleanup can be run once immediately, or scheduled to run automatically daily, weekly, monthly, or at every reboot, via cron(8).

Actions that require administrator privileges are carried out by a separate, verb-based privileged helper, invoked through pkexec(1). mx-cleanup itself must be started as a normal (non-root) user; it refuses to run when invoked as root.

OPTIONS

-h, --help
    Display help on command line options and exit.

--help-all
    Display help on command line options, including generic Qt/QPA options such as --platform, --session, and --reverse, and exit.

-v, --version
    Display version information and exit.

FILES

~/.config/MX-Linux/mx-cleanup.conf
    Per-user preferences (cache/thumbnail cleanup, flatpak, trash).

/usr/bin/mx-cleanup-script
    Generated cron/@reboot script for a user's own scheduled cleanup.

/usr/bin/mx-cleanup-system-script
    Shared, system-wide script (package cache, purge, logs, all-users trash) invoked by every user's scheduled cleanup script.

/etc/cron.daily/mx-cleanup
/etc/cron.weekly/mx-cleanup
/etc/cron.monthly/mx-cleanup
/etc/cron.d/mx-cleanup
    Cron entries installed for the selected schedule.

SEE ALSO
baobab(1), pkexec(1), cron(8)

AUTHOR
Written by Adrian and the MX Linux team.

COPYRIGHT
Copyright © 2018-2026 MX Authors. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.