=====How To Use a USB Drive For The VortexBox Media Library=====

Here are instructions for using a USB drive for your VortexBox media library. These instructions should work on both VortexBox 2.3 (Fedora 20) and VortexBox 2.4 (Fedora 23).

1. Prepare your USB drive. VortexBox media are in /storage:
<code>
Audio: /storage/music
LMS music library: /storage/music/flac
LMS playlists: /storage/music/playlist
Mirrored mp3 files: /storage/music/mp3
Images: /storage/pictures
Video: /storage/movies
</code>

To use an external USB drive for your VortexBox media, you'll have to create top-level folders **music**, **pictures**, and **movies** on the USB drive. You should also create a **music/flac** folder on your USB drive, and place your music files there (even if they are not FLAC files). Also create a **music/playlist** folder for LMS playlists. Create a **music/mp3** folder for VortexBox to use for mirroring FLAC files to mp3. Do not place any music files in music/mp3; place them in music/flac. Move your media files on the USB drive to the appropriate folders. This will allow you to mount the USB drive at /storage and have all your media show up in the proper place.

2. Remove all other USB drives (e.g. a backup drive) from your VB. Plug the desired USB drive into your VB.

3. Login to your VB; see [[VortexBox Command Line]]

4. Find the device name of the USB drive. Enter
<code>cat /etc/vortexbox/CurrentUsbDrive.txt</code>

On a VB with one internal hard drive, this usually shows /dev/sdb.

5. Mount the drive. Enter
<code>
umount /storage
mount /dev/sdb1 /storage
</code>

**Use the device name from step 4 with a "1" appended in the above command if it's not /dev/sdb.**

6. If this works, then automount the drive at boot time. Edit /etc/fstab. Enter
<code>nano /etc/fstab</code>

7. Remove any line that currently mounts /storage. This line may look like
<code>/dev/mapper/VolGroup-lv_storage /storage ext4 defaults 1 2</code>

If you installed VortexBox 2.3 using the "Small 2GB+ install" option, this line won't appear in /etc/fstab; just go on to the next step.

8. Add the line
<code>/dev/sdb1  /storage  ntfs  defaults 0 0</code>

**Use the correct device name if it's not /dev/sdb1.** This presumes the drive has a NTFS filesystem on it. If not, use the correct filesystem type in the above line.

9. Write the file (control-o) and quit (control-x).

10. Test the /etc/fstab entry by entering
<code>
umount /storage
mount -a
</code>

This should mount the USB drive at /storage.

11. If step 10 is successful, the USB drive will be automounted at /storage when the VB reboots.

12. If you want the proper drive to be automounted regardless of the device name, enter the command
<code>blkid /dev/sdb1</code>

**Use the correct device name in the above command if it's not /dev/sdb1.**

On my VortexBox, this returns
<code>/dev/sdb1: UUID="725A66165AF23401"  TYPE="ntfs"</code>

13. You can then change the step 8 line in /etc/fstab to
<code>UUID="725A66165AF23401" /storage ntfs defaults 0 0</code>

Use the UUID returned by the **blkid** command on your system.

14. After you have mounted the USB drive at /storage, change ownership of /storage/music/playlist so it can be written by Logitech Media Server:
<code>chown squeezeboxserver:squeezeboxserver /storage/music/playlist</code>