Skip to content

perunfsusage – User Manual

What is perunfsusage

perunfsusage is a command available on the login nodes of the PERUN cluster that shows an overview of your current disk space usage across the cluster's file systems (/mnt/home, /mnt/scratch, /mnt/project).

The report is generated automatically – running the command does not trigger a live calculation, it simply displays the most recently prepared report.

Base Environment

The command is available directly on the PERUN login nodes for every regular user, with no need to load any module.

How to run it

perunfsusage

The command takes no parameters and is available to every regular user.

What you'll see in the output

STORAGE USAGE FOR mahake799
Generated: 2026-08-07 04:56:08
  • Username the report was generated for.
  • Generation timestamp – when the report was last calculated (not the time you ran the command).

Usage table

Column Meaning
Type User = your personal data, Project = data belonging to a project
Name Username, or project name/ID
File system Which mount point the data lives on (/mnt/home, /mnt/scratch, /mnt/project)
Space used Actual space consumed
Space limit Assigned quota limit (TBD = no fixed limit yet)
Used % Percentage of the limit used (only shown when a limit is defined)
Status Project status: active / inactive (project rows only)

Summary

Your data:     4.46 TB
Project data:  51.1 TB
  • Your data – total of all your personal data across all file systems.
  • Project data – total of all data in projects you have access to.

Notices

Inactive Projects

If you have projects marked inactive (typically leftover from a previous year), the system flags them and recommends archiving or cleaning them up.

Important

If you're over the limit on any file system (e.g. /mnt/home), the report highlights it with a *** WARNING: you are over quota *** message and suggests concrete commands to find the biggest space consumers:

du -sh ~/* ~/.[!.]* 2>/dev/null | sort -rh | head -20

Best Practice

Cache directories (e.g. ~/.cache/huggingface, ~/.conda/pkgs, ~/.apptainer/cache) are usually the biggest space consumers and are safe to delete — they get rebuilt automatically on next use.

What "no limit" on /mnt/scratch means

Base Environment

/mnt/scratch (Lustre) has no fixed quota limit set (TBD = To Be Determined), so status and usage percentage are not shown for it. This space is intended for temporary/working data, not long-term storage.

What to do if you're over quota

Example Use Case

User mahake799 is at 203.6% quota on /mnt/home (1018 GB of 500 GB). Resolution steps:

  1. Identify the largest space consumers using the du command shown above.
  2. Delete unnecessary cache directories (e.g. ~/.cache/huggingface).
  3. Move large but not currently needed data to /mnt/scratch or local storage.
  4. Archive or request removal of the 8 inactive projects under /mnt/project.

Note

The report is generated automatically in the background; perunfsusage only displays its latest output — changes in space usage are not reflected instantly, but with some delay (depending on the refresh interval).