How to Find Wasted Disk usage With Agedu on Linux

terminal logo

agedu is a Linux tool used to track down the wasted disk usage. This tool will help you to find out the right stuff to delete and free up your disk space.

It scans a directory tree and produces reports about how much disk space is used in each directory and sub directory, and also how that usage of disk space corresponds to files with last-access times a long time ago.

Installing Agedu

On Ubuntu/Debian:

sk@sk:~$ sudo apt-get install agedu

On CentOS/RHEL:

Agedu package will not be found in official repositories. So first, add EPEL repository with the following command:

[root@server ~]# rpm -ivh http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm

Now install Agedu with following command:

[root@server ~]# yum install agedu -y

Usage

Syntax:


<b>agedu</b> [ <em>options</em> ] <em>action</em> [<em>action</em>...]

If you want to scan your home directory for disk usage, the command should be:

sk@sk:~$ agedu -s /home/sk/

The above command will scan all directories, sub directories for disk usage and build a large data file called agedu.dat in your current directory. If that current directory is inside /home/sk, it is smart enough to discount its own index file.

The sample output will be as shown below:

Built pathname index, 28928 entries, 2505705 bytes of index           
Faking directory atimes
Building index
Final index file size = 9538096 bytes

Now run the following command to see the reports:

sk@sk:~$ agedu -w

You will see an output like shown below:

Using Linux /proc/net magic authentication
URL: http://127.0.0.1:46389/

Open up your browser and enter the URL http://127.0.0.1:46389/ shown in the above output.

agedu: -home-sk- - Mozilla Firefox_001The above graphical output shows the disk usage of the /home/sk directory in various colors. You can figure out which files/directories should be removed to free up the disk usage from the above output. Click on any directory to view the disk usage of its sub directories. To exit from the command, just press CTRL+D.

Assign custom port for Agedu

Use the following command to assign the custom port for Agedu:

sk@sk:~$ agedu -w --address 127.0.0.1:9000

or

sk@sk:~$ agedu -w --address 192.168.1.100:9000

Here 192.168.1.100 is my local IP address. You may see the following output after entering the above command:

Using Linux /proc/net magic authentication
URL: http://127.0.0.1:9000/

Now you will able to access the Agedu web interface with URL http://127.0.0.1:9000 from your browser. To exit from Agedu command press CTRL+D.

Enable password protection for Agedu

You can secure Agedu web interface with a password. Use the following command to generate a password:

sk@sk:~$ agedu -w --address 127.0.0.1:9000 --auth basic

You may have the following output. Note down the username and password:

Username: agedu
Password: gehs92b5rf2y83mc
URL: http://127.0.0.1:9000/

It will create a username and password automatically for you. Open up the browser and navigate to http://127.0.0.1:9000. It will ask the username and password as shown below. Enter the username and password.

New Tab - Mozilla Firefox_004Now you will able to connect to the Agedu web interface.

agedu: -home-sk- - Mozilla Firefox_005

You can set a custom username and password if you like. To do so, enter the following command:

sk@sk:~$ agedu -w --address 127.0.0.1:9000 --auth basic --auth-fd 0

Now enter your username and password in the following format:

sk:password

You should enter the username (eg. sk) and put a colon (:) and password (eg. password). Afterwards, press CTRL+D to exit. Now you will be able to access Agedu web interface with new username and password.

View Agedu reports from terminal

To view the reports from the terminal, use the following command:

sk@sk:~$ agedu -t /home/sk/

You may see the following like output:

25606780    /home/sk/Personal
384         /home/sk/Pictures

To access files which are not looked(accessed) for six months or more, use the following command:

sk@sk:~$ agedu -t /home/sk/ -a 6m

You can use the switches d for days, w for weeks, m for months and y for years. For example, if you want to see the files which are not accessed 7 days or more, enter the following command:

sk@sk:~$ agedu -t /home/sk/ -a 7d

View reports of a particular types of files

For example, if you want to see the disk usage taken by PDF files and want to omit all other files, just enter the following command:

sk@sk:~$ agedu -s . --exclude '*' --include '*.pdf'

The above command will scan only for disk usage taken by PDF files in the current directory and it omit all other types of files from scanning.

To view the report, enter the following command:

sk@sk:~$ agedu -w
Using Linux /proc/net magic authentication
URL: http://127.0.0.1:52272/

Open up browser and navigate to URL http://127.0.0.1:52272/. Now you will see the output only for disk usage taken by PDF files.

agedu: -home-sk- - Mozilla Firefox_006Suppose if you want to access the reports from a particular directory for a particular types of files, use the following command:

sk@sk:~$ agedu -s /home/sk/Downloads --exclude '*' --include '*.pdf'

The above command scans PDF files in the /home/sk/Downloads and omits all other directories and file types.

Deleting unused files

You have found out which directory is not using for long time, you can simply delete the directory or multiple directories with following command to free up the disk space:

sk@sk:~$ rm -fr directoryname

To delete the index file, enter the following command:

sk@sk:~$ agedu -R

or

rm -fr agedu.dat

To know more Agedu commands, refer the man pages.

sk@sk:~$ man agedu

That’s it.