Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/adileo/squirreldisk/llms.txt

Use this file to discover all available pages before exploring further.

SquirrelDisk is currently distributed as a .deb package for Debian-based distributions (Ubuntu, Debian, Linux Mint, Pop!_OS, etc.).

Download

Download the latest .deb package from the GitHub releases page.

Installation Steps

1

Download the Package

Download the .deb file for your architecture (usually amd64 for 64-bit systems):
# Example - replace with actual version number
wget https://github.com/adileo/squirreldisk/releases/download/v0.3.4/squirreldisk_0.3.4_amd64.deb
2

Install the Package

Install using dpkg:
sudo dpkg -i squirreldisk_*.deb
The * wildcard will match any version of the package in your current directory.
3

Install Dependencies (if needed)

If you encounter dependency errors, run:
sudo apt-get install -f
This will automatically install any missing dependencies.
4

Launch SquirrelDisk

You can now launch SquirrelDisk from your application menu or by running:
squirreldisk

Alternative Installation Methods

Using APT (After downloading .deb)

sudo apt install ./squirreldisk_*.deb
Using apt install or gdebi will automatically handle dependencies.

System Requirements

  • Ubuntu 18.04 or later (or equivalent Debian-based distribution)
  • 64-bit processor (amd64)
  • Minimum 2GB RAM recommended
  • GTK 3.0 or later (usually pre-installed)

Dependencies

According to the build configuration, SquirrelDisk has no additional package dependencies beyond what’s typically installed on a standard desktop Linux system. The application bundles all required components.

Troubleshooting

Package Installation Fails

If you see errors during installation:
# Check for dependency issues
sudo apt-get install -f

# Or try reinstalling
sudo dpkg -i --force-overwrite squirreldisk_*.deb

Command Not Found

If squirreldisk command is not found after installation:
  1. Verify the installation:
    dpkg -l | grep squirreldisk
    
  2. Check the installation location:
    which squirreldisk
    
  3. Try launching from the full path:
    /usr/bin/squirreldisk
    

Permission Denied Errors

If SquirrelDisk can’t access certain directories:
  • Run the app with elevated privileges to scan system directories:
    sudo squirreldisk
    
Running GUI applications with sudo can pose security risks. Only do this when necessary to scan system directories.

App Won’t Start or Crashes

  1. Check if all dependencies are installed:
    ldd /usr/bin/squirreldisk
    
  2. Run from terminal to see error messages:
    squirreldisk
    
  3. Check system logs:
    journalctl -xe | grep squirreldisk
    
  4. Report the issue on the GitHub issue page with error output

Missing GTK or Graphics Libraries

If you get errors about missing GTK libraries:
sudo apt-get install libgtk-3-0 libwebkit2gtk-4.0-37

Uninstallation

To remove SquirrelDisk:
sudo apt remove squirreldisk
To remove including configuration files:
sudo apt purge squirreldisk

Updates

SquirrelDisk includes an auto-updater that checks for new versions when you launch the app. However, on Linux, you may need to manually download and install updates.
To update to a new version:
  1. Download the latest .deb package
  2. Install it using the same commands - it will upgrade the existing installation:
    sudo dpkg -i squirreldisk_*.deb
    

Build docs developers (and LLMs) love