Back to Commands

umount

file managementLinux/Unix

The umount command is one of the most frequently used commands in Linux/Unix-like operating systems. umount Unmount file systems

See Examples View Syntax

Quick Reference

Command Name:

umount

Category:

file management

Platform:

Linux/Unix

Basic Usage:

umount [options] [arguments]

Common Use Cases

Syntax

umount [options] <source> | <directory>

Options

Option	Description
`-a, --all`	Unmount all file systems described in /etc/mtab
`-A, --all-targets`	Unmount all mountpoints for the specified device in the current namespace
`-c, --no-canonicalize`	Don't canonicalize paths
`-d, --detach-loop`	When unmounting a loop device, also free the loop device
`-f, --force`	Force unmount (in case of an unreachable NFS system)
`-i, --internal-only`	Don't call the umount.<type> helper even if it exists
`-l, --lazy`	Detach the filesystem now, clean up references later
`-n, --no-mtab`	Don't write to /etc/mtab
`-O, --test-opts <list>`	Limit the set of filesystems (use with -a)
`-q, --quiet`	Suppress 'not mounted' error messages
`-R, --recursive`	Recursively unmount a target with all its children
`-r, --read-only`	If unmounting fails, try to remount read-only
`-t, --types <list>`	Limit the set of filesystem types
`-v, --verbose`	Say what is being done
`-h, --help`	Display help text and exit
`-V, --version`	Print version and exit

Examples

How to Use These Examples

The examples below show common ways to use the umount command. Try them in your terminal to see the results. You can copy any example by clicking on the code block.

# Basic Examples Basic

# Unmount a file system by mount point sudo umount /mnt/usb

# Unmount a file system by device sudo umount /dev/sdb1

# Unmount all file systems of a specific type sudo umount -a -t nfs

# Advanced Examples Advanced

# Lazy unmount - unmount as soon as it's not busy sudo umount -l /mnt/busy_mount

# Force unmount even if the device is busy sudo umount -f /mnt/stubborn_mount # Unmount and show verbose output sudo umount -v /mnt/usb # Unmount all filesystems except root sudo umount -a # Unmount all filesystems of a specific type with verbose output sudo umount -av -t tmpfs # Check if a directory is a mountpoint without unmounting umount -l /mnt/check_if_mounted # Try to unmount with a specified timeout (Linux only) sudo umount -t 5 /mnt/usb # Unmount all filesystems in an alternate root directory sudo umount -a --rbind-recursive /mnt/chroot # Unmount using the file system UUID sudo umount UUID=123e4567-e89b-12d3-a456-426614174000 # Find and unmount a device by label sudo umount LABEL=BACKUP_DRIVE # Unmount using the file system's mount tag sudo umount -n /mnt/usb

Try It Yourself

Practice makes perfect! The best way to learn is by trying these examples on your own system with real files.

Understanding Syntax

Pay attention to the syntax coloring: commands, options, and file paths are highlighted differently.

Notes

The `umount` command is used to unmount file systems in Linux and Unix-like operating systems. When a file system is unmounted, it is detached from the directory tree, making its contents inaccessible to users and processes. This command is the counterpart to the `mount` command, which attaches file systems to the directory tree. Proper unmounting is crucial for maintaining file system integrity. When a file system is mounted, the operating system caches data to improve performance. If you were to simply remove a device (like a USB drive) without unmounting it first, any cached data that hasn't been written to the device could be lost, potentially corrupting the file system. The `umount` command can be invoked in several ways: 1. **By mount point**: `umount /mnt/usb` - This unmounts whatever file system is mounted at the directory `/mnt/usb`. 2. **By device**: `umount /dev/sdb1` - This unmounts the file system on the specified device, regardless of where it's mounted. 3. **By other identifiers**: Modern Linux systems also support unmounting by UUID, label, or other identifiers. In addition to basic unmounting, `umount` provides several useful options: - **Lazy unmounting** (`-l`): This detaches the file system immediately and cleans up references later, when they're no longer busy. This is useful when a process is still accessing the file system but you need to unmount it now. - **Force unmounting** (`-f`): This forcibly unmounts a file system, even if it's busy. This can be dangerous and may lead to data loss if files are being written to, but it's sometimes necessary for unresponsive NFS mounts. - **Recursive unmounting** (`-R`): This unmounts not just the specified mount point, but also any file systems mounted beneath it. - **Type-specific unmounting** (`-t`): This allows you to unmount only file systems of a specific type, such as `nfs`, `ext4`, or `tmpfs`. - **Verbose output** (`-v`): This shows what the command is doing, which can be helpful for debugging or learning. Only root (or users with appropriate sudo privileges) can unmount file systems that aren't specifically configured to allow user unmounting in `/etc/fstab` (using the `user` or `users` option). One common issue with unmounting is dealing with "device is busy" errors. This happens when a process is still using the file system. To find out which processes are using a mount point, you can use commands like `fuser` or `lsof`. Once identified, these processes can be terminated or otherwise dealt with before attempting to unmount again. For systems with systemd, the `systemctl` command may also be used to manage mounts defined as systemd mount units, offering an alternative approach to mounting and unmounting file systems.

Related Commands

These commands are frequently used alongside umount or serve similar purposes:

Explore All Commands

Use Cases

Learn By Doing

The best way to learn Linux commands is by practicing. Try out these examples in your terminal to build muscle memory and understand how the umount command works in different scenarios.

See Examples Try Lab Exercises

$ umount

View All Commands