User Tools

Site Tools


Quick Start for Adding a USB drive

Many useful LEDE utilities and packages rely on external storage to hold data files. This guide describes how to add a single USB stick or drive to your LEDE device.


  • Your LEDE device must have at least 8 MB Flash. Lower capacity devices will not be able to hold the required packages.
  • This procedure will work for the first USB device installed in the router. To add more drives, see the full USB Drive tutorial.
  • This procedure WILL ERASE THE USB DRIVE. Copy any data you care about to another destination.
  • This quickstart requires you to ssh into the router.


  1. Connect the USB stick/disk to the router.
  2. Enter the following commands by copying and pasting each separate line below.
# Copy/paste each line below, then press Return
opkg update && opkg install block-mount e2fsprogs kmod-fs-ext4 kmod-usb3 kmod-usb2 kmod-usb-storage
mkfs.ext4 /dev/sda1
block detect > /etc/config/fstab 
uci set fstab.@mount[0].enabled='1' && uci set fstab.@global[0].check_fs='1' && uci commit 
/sbin/block mount && service fstab enable

The drive will be mounted at /mnt/sda1 You can change the mount point in the web interface, in SystemMount Points.

If you want more information about this procedure, or you want to add or configure more than a single USB drive, see the full USB Drive tutorial .

docs/guide-user/storage/usb-drives-quickstart.txt · Last modified: 2018/08/12 21:10 by tmomas