
Ubuntu 26.04 LTS “Resolute Raccoon” is powerful, modern, and built on Linux 7.0, but it accumulates junk files faster than most users realize. Your APT cache grows with every package update, old log files stack up in /var/log, and application caches quietly eat gigabytes in your home directory. This guide shows you exactly how to install BleachBit on Ubuntu 26.04 LTS using three different methods, plus how to use it safely without breaking anything. Whether you are a first-time Linux user or a sysadmin managing a fleet of Ubuntu desktops, this tutorial gives you the commands, the reasoning, and the safety guardrails to do it right.
BleachBit is a free, open-source disk cleaner and privacy manager licensed under GPLv3. The latest stable release, BleachBit 5.0, shipped in early 2025 with major improvements specifically for Linux users, including new cleaners for LibreWolf, Discord, Microsoft Edge (non-beta), Geary, Bash temporary files, and broken .desktop entries. It also introduced a panel indicator icon so you can see at a glance when BleachBit is running, which is genuinely useful on a busy desktop.
Ubuntu 26.04 generates clutter from multiple sources at once. The APT package manager stores every downloaded .deb file in /var/cache/apt/archives/ and never deletes them automatically. GNOME 50, which ships with Resolute Raccoon, comes with new default apps that create their own cache directories right from first boot. On a machine that has been in use for even a few weeks, you can easily accumulate 1.5 GB or more in APT cache alone, and that does not count browser caches, thumbnail caches, or rotated log files.
This tutorial covers three installation methods: APT (Ubuntu repository), official .deb package from bleachbit.org (recommended for the latest version), and a fully command-line wget method for headless or terminal-only setups. Each step explains not just the command, but why you are running it, because understanding the reason behind a command is what separates someone who knows Linux from someone who just copies and pastes.
Prerequisites Before You Begin
Before you run a single command, confirm these items. Skipping this step is one of the top reasons Ubuntu tutorials fail midway through.
System requirements for Ubuntu 26.04 LTS (Resolute Raccoon):
- 2 GHz dual-core processor or better
- Minimum 6 GB RAM
- Minimum 25 GB free storage (desktop install)
What you need before installing BleachBit:
- Ubuntu 26.04 LTS installed and running (desktop or server)
- A user account with
sudoprivileges — standard install gives you this by default - An active internet connection to pull packages or download the
.debfile - Basic terminal familiarity — you only need to know how to open a terminal and paste commands
- At least 100 MB of free disk space — BleachBit itself is small, but APT needs room to work
Verify your Ubuntu version before anything else:
cat /etc/os-release
You should see VERSION_ID="26.04" and VERSION_CODENAME="resolute" in the output. If you see a different version, the .deb package filenames in this guide will not match your system and you will hit dependency errors.
Verify your sudo access:
sudo whoami
Expected output: root. If you get a permission denied error, you need to contact your system administrator before proceeding.
Step 1: Update Your System Package Index
The first thing you do before any software installation on Ubuntu is refresh the package index. This is not optional.
sudo apt update
What this does: It contacts Ubuntu’s repository servers and downloads an updated list of available packages and their versions. Your local package index is a database stored in /var/lib/apt/lists/. It gets stale quickly, especially if you have not run an update in a few days.
Why this matters: If you skip this step, APT may attempt to resolve BleachBit’s dependencies against outdated version data. That leads to version mismatches, failed installs, or APT pulling in older library versions that conflict with packages already on your system. One apt update before installing anything is one of the most important habits you can build as a Linux user.
Expected output (partial):
Hit:1 http://archive.ubuntu.com/ubuntu resolute InRelease
Hit:2 http://archive.ubuntu.com/ubuntu resolute-updates InRelease
Reading package lists... Done
Building dependency tree... Done
You do not need to see “upgradeable” packages for this step to succeed. You just need it to complete without errors.
Step 2: How To Install BleachBit on Ubuntu 26.04 LTS via APT
This is the fastest method. It pulls BleachBit directly from Ubuntu’s official repository in a single command.
Install BleachBit with APT
sudo apt install bleachbit -y
What this does: APT searches the Ubuntu 26.04 repository for the bleachbit package, automatically identifies all required dependencies (Python 3, GTK libraries, and others), downloads them, and installs everything in sequence.
Why APT over anything else for beginners: APT handles dependency resolution automatically. If you used dpkg -i instead, it would halt the install the moment it found a missing library and leave your package database in a partially broken state that requires manual repair. APT is the smarter, safer option for most users.
Why use -y: The -y flag confirms the installation prompt automatically. Remove it if you want to review the list of packages APT plans to install before confirming.
Verify the install:
bleachbit --version
Expected output:
BleachBit version 5.0.2
If this command returns command not found, run sudo apt install -f to repair any broken dependencies, then try again.
The trade-off with this method: Ubuntu’s repository version may lag slightly behind the upstream release. You might get BleachBit 4.6.x instead of 5.0.x, depending on when the maintainers packaged the new version. If you need the latest version with all the new cleaners, use Method 2 below.
Step 3: Install BleachBit via Official .deb Package (Recommended)
This is the method I recommend to most users and the one I use on my own machines. You get the latest stable BleachBit build, packaged specifically for Ubuntu 26.04.
Download the Official Package
Go to bleachbit.org/download/linux and download the .deb file for Ubuntu 26.04. The filename will look like:
bleachbit_5.0.2-0_all_ubuntu2604.deb
Or use wget to download it directly in the terminal:
wget https://download.bleachbit.org/bleachbit_5.0.2-0_all_ubuntu2604.deb
Why download from the official site only: Third-party mirrors carry a real risk of tampered binaries. BleachBit is a tool that runs as root and deletes files across your entire system. You need absolute confidence that you are running the real, unmodified package. The official bleachbit.org domain is the only guaranteed clean source.
Install the .deb Package Using APT
sudo apt install ./bleachbit_5.0.2-0_all_ubuntu2604.deb
Critical: Note the ./ prefix. Without it, APT interprets the argument as a package name to search in the repository, not a local file path. It will either install the wrong version or return an “Unable to locate package” error.
Why use apt instead of dpkg -i here: apt automatically pulls in any missing dependencies from the Ubuntu repository before completing the install. dpkg -i installs the package in isolation and fails hard if any dependency is not already present, leaving your system in an inconsistent state. Use apt every time.
Confirm the Installation
bleachbit --version
apt list --installed 2>/dev/null | grep bleachbit
The second command is important. It confirms that APT is now tracking BleachBit as an installed package. This means future sudo apt upgrade runs will automatically update BleachBit when a new version becomes available.
Expected output:
bleachbit/now 5.0.2-0 all [installed,local]
Clean Up the Downloaded File
rm bleachbit_5.0.2-0_all_ubuntu2604.deb
Why this step matters: The .deb file served its purpose the moment the install completed. Leaving it in your home directory adds to the exact kind of clutter BleachBit exists to remove. It is a small thing, but these habits compound over time on a long-running machine.
Step 4: Install BleachBit via Command Line (wget + apt for Headless Servers)
If you are on an Ubuntu 26.04 server without a GUI, or running a minimal desktop install without a browser, this is your method. It is also the right choice for automated provisioning scripts.
Upgrade the System First
sudo apt update && sudo apt upgrade -y
Why upgrade before installing: GTK and Python libraries that BleachBit depends on may have received security patches since your last update. Installing BleachBit on top of outdated library versions can cause runtime crashes that are frustrating to diagnose. Running upgrade first gives you a clean, stable foundation.
Download with wget
wget https://download.bleachbit.org/bleachbit_5.0.2-0_all_ubuntu2604.deb
Install and Remove the Package File
sudo apt install ./bleachbit_5.0.2-0_all_ubuntu2604.deb -y
rm bleachbit_5.0.2-0_all_ubuntu2604.deb
Check free disk space before and after to confirm the install completed as expected:
df -h /
Note the value in the “Avail” column. After installation, this number should decrease by only a few megabytes, confirming a normal install footprint.
Step 5: Launch BleachBit on Ubuntu 26.04
Launch via GNOME Activities (Desktop)
Press the Super key (Windows key), type “BleachBit” into the search bar, and you will see two entries:
- BleachBit — runs as your regular user account
- BleachBit as Administrator — runs with root privileges via
pkexec
Launch via Terminal
For the standard user mode:
bleachbit
For administrator mode:
sudo bleachbit

Why Two Separate Modes Exist
This is one of the most misunderstood aspects of BleachBit. Running as a regular user cleans files inside your home directory: browser caches in ~/.cache, Firefox profiles, GNOME thumbnail cache, Bash history, and other user-level data.
Running as administrator cleans system-wide directories: /var/cache/apt/archives/, system logs in /var/log/, localization files, and broken .desktop entries in /usr/share/applications/.
The correct workflow is to run both, in that order. Run user mode first, then admin mode. If you only run admin mode, you miss everything stored under your home directory. This is a mistake I see constantly from users who think “running as root cleans more,” but root cannot see inside your user cache directories without knowing the specific path.
Step 6: Use BleachBit Safely on Ubuntu 26.04
Always Preview Before You Clean
Before you click the Clean button, always click Preview first. This is non-negotiable.
Why: Preview scans every item you have selected and generates a complete file list with estimated space savings, without deleting anything. It lets you see exactly what BleachBit plans to remove so you can decide if something looks wrong before it is gone permanently.
There is no recycle bin and no undo.
Safe Cleaners to Check on Ubuntu 26.04 LTS
These are low-risk selections that most users should feel confident enabling:
- APT cache — removes stored
.debfiles from/var/cache/apt/archives/; safe to delete since APT re-downloads packages if needed - System temporary files —
/tmpand/var/tmpentries left over from crashed or completed processes - Rotated system logs — old compressed log archives in
/var/log/; the current log remains untouched - Browser cache — Chromium, Firefox, or LibreWolf cache files (does NOT include cookies or passwords if you select only “Cache”)
- Thumbnail cache — GNOME stores thumbnails for every image you have ever opened; this directory grows silently and can reach hundreds of megabytes
What to Avoid Checking
These options carry irreversible risk if used carelessly:
- Saved Passwords (any browser) — permanently deletes all stored credentials with no recovery option
- Overwrite Free Space — writes random data across all free disk blocks to prevent forensic recovery; this takes hours, hammers your disk with write cycles, and provides zero benefit unless you are decommissioning the drive
- Cookies — only clear these if you are fine logging back into every website you use
Overwrite Free Space and SSDs: A Hard Warning
If your Ubuntu 26.04 machine uses an SSD (which is almost every machine sold in the last five years), never enable “Overwrite Free Space.” SSDs have a finite number of write cycles per cell. Overwriting free space accelerates wear, shortens drive lifespan, and accomplishes nothing useful on a drive you still own and use. This feature was designed for spinning hard drives being decommissioned.
Execute and Audit
After reviewing the Preview output, click Clean. When the process finishes, go to File > View Log inside BleachBit. This log lists every file and directory that was deleted with exact paths.
If any application behaves oddly after a cleaning session, the log is your first diagnostic tool. Look for paths that match the application’s config or data directory, not just its cache directory.
Troubleshooting Common BleachBit Issues on Ubuntu 26.04
Error 1: “Unable to locate package bleachbit” (APT method)
Cause: The package index is stale or the repository does not yet carry BleachBit 5.0.x for Ubuntu 26.04.
Fix:
sudo apt update
sudo apt install bleachbit
If it still fails, switch to Method 2 (official .deb from bleachbit.org).
Error 2: “Unmet dependencies” after dpkg install attempt
Cause: You used dpkg -i instead of apt install. dpkg does not resolve dependencies automatically.
Fix:
sudo apt install -f
This tells APT to “fix broken” packages by pulling in the missing dependencies. Run bleachbit --version afterward to confirm the repair worked.
Error 3: “Permission denied” when running BleachBit as administrator
Cause: The pkexec authorization agent is not running, which can happen after a GNOME session issue.
Fix: Launch from the terminal directly:
sudo bleachbit
If you prefer the GUI launcher to work, restart your session: log out and log back in.
Error 4: “command not found” after a successful apt install
Cause: The BleachBit binary is not in your current $PATH, or the install silently failed due to a disk space issue.
Fix:
which bleachbit
ls /usr/bin/bleachbit
If the binary exists but is not found, reload your $PATH with:
source ~/.bashrc
If the binary does not exist at all, reinstall:
sudo apt install --reinstall bleachbit
Error 5: BleachBit crashes on launch (GTK error)
Cause: GTK library versions are mismatched, usually because packages were installed out of order or APT was interrupted mid-upgrade.
Fix:
sudo apt update && sudo apt upgrade -y
sudo apt install --reinstall bleachbit
This refreshes the full dependency chain and resolves most GTK-related crashes on Ubuntu 26.04.
How to Uninstall BleachBit from Ubuntu 26.04 LTS
If you decide you no longer need it, removing BleachBit cleanly takes two commands.
Remove the application:
sudo apt remove bleachbit
Why apt remove and not just deleting the binary: apt remove updates the package database to reflect that BleachBit is gone. Manually deleting /usr/bin/bleachbit leaves orphaned entries in APT’s records, which causes confusing output in future apt list --installed calls.
Remove unused dependencies:
sudo apt autoremove
Why this second step matters: APT installed several supporting libraries when BleachBit was set up. autoremove identifies packages that exist solely to support BleachBit and removes them too, reclaiming additional disk space.
Remove configuration files too (optional):
sudo apt purge bleachbit
Use purge instead of remove if you are handing the machine to another user or plan to do a clean reinstall. purge removes both the binaries and any global configuration files.
Congratulations! You have successfully installed BleachBit. Thanks for using this tutorial for installing BleachBit on the Ubuntu 26.04 LTS esolute Raccoon system. For additional help or useful information, we recommend you check the official BleachBit website.