When to use umount
Use umount to detach a mounted filesystem after stopping dependent activity. Verify the exact mountpoint and open users of it; forcing a busy production mount can interrupt services or lose pending work.
Syntax
umount [PARAMETERS] DEVICE_OR_DIRECTORYSquare brackets mark optional arguments; an ellipsis means repetition. Replace example file names, user names and server addresses with your own values.
Common options and arguments
Usage examples
View current mounts
findmntThe current mount relationships are listed to identify the target.
Find open files at the mount point
sudo lsof +f -- /mnt/terminalus-demoOpen users of the selected filesystem are inspected before attempting detachment.
Unmount the allocated test partition
sudo umount /mnt/terminalus-demoThe target mountpoint is unmounted if it is not busy and policy permits.
Notes and limitations
- The command is spelled umount, without an n after the u.
- If a mount point is busy, find the cause first. Forced or lazy unmounting is not a universal fix.
Common questions and troubleshooting
Why does umount report target is busy?
Processes may have open files or a working directory on that filesystem, or child mounts may remain. Identify and stop the relevant activity cleanly.
Should I use force or lazy unmount immediately?
No. Those modes have specific semantics and can hide unresolved activity. Understand the cause and follow the storage recovery procedure.
Further help
Options vary by version and distribution. Check the installed documentation with this command: man umount.