How-to Guide: Automatically Mount an External USB Storage Device at Boot Time, and Within Emulation Station
This how-to guide shows a method to automatically mount an external USB drive on the Raspberry Pi. The general technique which I have adopted and is common, and whilst there are similar guides available, I have adapted the approach specifically for use on a Pi running Raspbian Lxde Desktop, Kodi Media Center, and Emulation Station with RetroPie.
In this article I aim both to demonstrate and expand upon the steps involved, whilst highlighting some issues which I have encountered when using this approach, and providing their resolutions.
- A Little Background Information
- Automount Options
- Using the lsusb Command
- Automount from Boot or within Emulation Station
- Manually Unmounting an Automounted USB Drive
- Notes Regarding Raspbian Desktop’s Automount Feature
- Using an External Drive with an NTFS File System
- Related Posts
- External Links
A Little Background Information
My Raspberry Pi 3 is setup to serve triple duty as a lightweight PC replacement, running the Raspbian desktop, as a media center using Kodi, and as a retro video game emulator suite, via RetroPie. I have my machine set to boot to a custom menu at the command prompt, rather than directly to the desktop, to facilitate easy switching between these options. Please see the Related Posts section for setup guides detailing how this was achieved.
The Raspbian kernel does not automatically mount external USB drives by default; this isn’t an issue when launching the Kodi media center, or the desktop, as both have the capability to detect and mount a USB hard disk or flash storage device once it is connected.
If the system is configured to boot directly to the command line, or to an application suite such as RetroPie‘s Emulation Station GUI, a connected drive will be inaccessible, although it is detected as present by the system.
This was a problem I needed to resolve, as I have customised RetroPie’s RetroArch subsystem to allow the Libretro emulators to record live audio-video footage during gameplay, an intensive task which is generally runs smoothly only when the output is directed to a fast storage medium such as an external hard disk.
For further details on Libretro and RetroArch, please see the What is RetroArch? section in the post RetroPie system overview – software and hardware components, and the related article: RetroPie Emulation: RetroArch, Libretro, and the Power of the Options Menu
mount command instructs the operating system that a file system is ready to use, and associates it with a particular point in the overall file system hierarchy (its mount point) and sets options relating to its access.
Mounting makes file systems, files, directories, devices and special files available for use and available to the user
[Definition from Wikipedia]
As is typical on a Linux system, there are multiple ways to achieve the goal of automatically mounting an external USB drive; generally these directly or indirectly use the
mount command, which in turn utilises entries in the
One workable, if unwieldy, option on a system with the Raspbian desktop installed is to launch Lxde, attach a USB drive, allow it to be automatically mounted, then exit to the command line. The drive will remain mounted and be present when Emulation Station, for example, is started.
Another approach is to use a wrapper named
pmount; this command provides an automounting mechanism similar to that provided by the Raspbian desktop, without requiring explicit entries in
pmount package is not installed by default.
fstab system file is a simple, if somewhat inflexible, alternative. It has the advantage of requiring no additional packages, and of clearly and consistently mapping a specific external device to a specific mount point.
This latter point is useful for my requirements given that when recording from RetroArch emulators, the launch command must explicitly provide the path and file name as parameters.
According to the Wikipedia fstab entry the
fstab (or file systems table) file is a system configuration file commonly found at
/etc/fstab [which] typically lists all available disk partitions and other types of file systems and data sources… and indicates how they are to be initialized or otherwise integrated into the larger file system structure.
fstab file is read by the
mount command, which happens automatically at boot time to determine the overall file system structure, and thereafter when a user executes the
mount command to modify that structure.
Using the lsusb Command
A step which is not strictly required, but may well be worth undertaking to avoid headaches later, is to run the
lsusb command to determine that a drive has been detected by the system.
Before connecting an external USB storage device, at the terminal issue:
This will output a list of all USB devices attached to the system, including the in-built USB hub, and USB-based ethernet.
Next, plug in the USB storage device, and re-run the command; if the system has successfully detected the device, a new entry will appear in the list. In the following image a Kingston USB drive (circled in yellow) has been connected:
Automount from Boot or within Emulation Station
In the following steps we’ll modify the
fstab file to allow direct automounting, either as the system boots, while at the command line, or whilst Emulation Station is running.
First we need to obtain the external USB device’s unique UUID. This can be achieved either by issuing the command:
ls -l /dev/disk/by-uuid/
Or, my personal preference, using the
blkid command, which has the advantage of displaying the drive’s label and file system type, making identification of a specific device much easier. A the command line or within a terminal window, run:
The resulting output of using
blkid should appear similar to the following:
/dev/mmcblk0: PTUUID="b3ff2c23" PTTYPE="dos"
/dev/mmcblk0p1: SEC_TYPE="msdos" LABEL="boot" UUID="2A5C-3F20" TYPE="vfat" PARTUUID="b3ff2c23-01"
/dev/mmcblk0p2: UUID="c320462b-3cdc-49c1-ac93-41f46268295d" TYPE="ext4" PARTUUID="b3ff2c23-01"
/dev/sda1: LABEL="3TB-HDD" UUID="FA3033A6A3E7F82B" TYPE="ntfs"
Entries in the form:
/dev/mmcblk0* are partitions on the Raspberry Pi‘s SD Card.
In the case of a Pi with a single USB drive attached, the external disk can be found at
/dev/sda1 (here, an entry with a LABEL value of “3TB-HDD”).
I use a name which differs from the drive’s label, as the Raspbian desktop’s automatic mechanism uses this when creating a temporary mount point directory.
Please see the section Notes Regarding Raspbian Desktop’s Automount Feature for further details.
Next, we need to create a directory to act as the mount point for the external drive:
sudo mkdir /media/pi/3TB-HDD-AUTO
Set ownership of the new directory to the
Pi user, and the
sudo chown -R pi:pi /media/pi/3TB-HDD-AUTO
Please note: this approach creates an entry unique to a specific external USB drive; if multiple drives are to be used it is necessary to repeat the procedure for each, adding additional lines to the
fstab file. This contrasts with the more flexbile mechanism incorporated into the
Raspbian desktop, and the
pmount wrapper package.
The next step involves editing
fstab. As good practice, it’s worth beginning by making a backup of the file:
sudo cp /etc/fstab /etc/fstab.bak
Next, edit the file. In this example I’m using the in-built
sudo nano /etc/fstab
At the end of the file add the following (all on a single line), substituting the previously determined UUID and the desired mount point directory name:
UUID=FA3033A6A3E7F82B /media/pi/3TB-HDD-AUTO ntfs nofail,noatime,auto,users,rw,uid=1000,gid=100,umask=0002 0 0
uid=1000 is the pi user
gid=100 is the pi group
umask=0002 sets permissions for the mount point to
nofail,noatime prevent system waiting 1 minute 30 seconds during boot if the external disk is not attached. This also prevents the system entering ’emergency mode’ at the console after booting.
Finally, the system must be rebooted for the updates to
fstab to take effect.
Following the reboot, whenever the USB drive is plugged in it will automatically be mounted, and accessible from the directory specified in the
Manually Unmounting an Automounted USB Drive
To dismount a drive which has been automatically mounted via an
fstab entry, use the
umount command. Please note that the spelling is
umount and not
sudo umount /path/directory
The value of
/path/directory must match the mount point specified in the corresponding
fstab entry, for example:
sudo umount /media/pi/3TB-HDD-AUTO
Using an External Drive with an NTFS File System
On a reasonably new Raspbian installation the operating system will include a package which provides compatibility with the Microsoft NTFS file system, as used on Windows systems dating back to NT4 and Windows 2000.
If you are experiencing problems using an external drive formatted as NTFS, check if the
ntfs-3g package is installed:
dpkg -L ntfs-3g
ntfs-3g is installed, the system will display a list of directories containing the package’s components, otherwise the following message is shown:
“dpkg-query: package ‘ntfs-3gc’ is not installed”
Should this be the case, you can install the package by issuing the command:
sudo apt-get install ntfs-3g
Notes Regarding Raspbian Desktop’s Automount Feature
If an external USB storage device which is present in
fstab is connected at the Raspbian desktop, it will automount to the directory specified. This contrasts with the default behaviour, which is to use the device’s label to automatically create a temporary directory of the same name within
If a device mounted via an
fstab entry is unmounted via the Ejector Panel item on the Raspbian desktop, the associated mount point directory will not automatically be removed. This is in contrast to the temporary folders created by the Raspbian desktop automount mechanism.
When a drive present in
fstab, with a mount point directory matching the drive’s label, is connected only once the desktop has loaded, error messages regarding file locks, and ‘temporarily unavailable’ warnings may be displayed. This appears to be due to the system attempting to create a temporary directory with the same name. The drive is, however, mounted and accessible.
Alternatively, I have witnessed the desktop automount mechanism creating a temporary mount point directory name comprising the drive label plus a numeric suffix, thus avoiding the conflict.
Given the possibility of conflicts between the two mechanisms, it is worth ensuring the
fstab specifies a mount point which differs from the device’s label.
A Labour of Love
- Don’t Fear The Command Line: Raspbian Linux Shell Commands and Tools – Part 1
- Navigating the Raspberry Pi’s File System. Raspbian Linux Shell Commands and Tools – Part 2
- Links: Raspberry Pi and Gaming Emulation via RetroPie
- Overview of Raspberry Pi and retro-gaming system hardware
- Retro gaming emulation on the Raspberry Pi with RetroPie
- Multipurpose Raspberry Pi: Installing a Media, Gaming, PC Replacement
- Multipurpose Raspberry Pi – Part 2: Adding a Menu to Access RetroPie, Kodi, and the Raspbian Desktop
RetroPie Manual Installation Guide, including the Version 4 Setup Script Revised Menu Structure