[Tutorial] How to allow APPS to acces external drives as a noob

I am noob and I had a nightmare with this simple thing, so I’m just sharing how I solved this problem
It may sound so simple and stupid for advanced users but this is for noobs like me

I had some apps like Immich and Syncthing I wanted my ZimaOS device to access and I couldn’t

Why I couldn’t?

  • It is simple, the directory the NVME and HDD had on the “files” app doesn’t match the real location of the storage device

What to do (STEPS)

  1. Open terminal


    SETTINGS > DEVELOPER > WEB TERMINAL

  2. PASTE THIS CODE

lsblk -o NAME,FSTYPE,LABEL,UUID,MOUNTPOINT,SIZE

````3. Identify the Disk`

Ignore everything and identify the unit in may case you can see SDA (sata connection is 4tb) nvme via PCIE is 1.9 tb

  1. MOUNTPOINT COLUMN OF THE LAST IMAGE
    That is the real location of your storage unit

  2. SET THE STORAGE UNIT ACCES FOR YOUR APP
    Open app configuration

  3. SET THE REAL FILE LOCATION FOR THE APP
    In Volumes you can see you have 2 columns, ok so the column on the left means the original location and the column of the right is the location that the app you are using will recognize

  • RED - Set the directory you found on the terminal
  • GREEN - The SHORTCUT that app will find
  1. SAVE

  2. ON THE APP

If the app asks you about a directory you have to put the - GREEN - Directory
if the green directory has a subdirectory you can access to it by for example /SYNC/SubdirectoryFolderName

3 Likes

I believe there’s an important correction. Pointing apps to raw mount paths under
/mnt/<uuid> is not recommended. I suggest avoiding this because those paths can change after reboot, disk refresh, or pool rebuild. They also bypass the ZimaOS storage layer, which may cause the app to lose access, create permission issues, or break backup/restore.

I suggest always mapping storage from the ZimaOS pool instead, for example:

/DATA/Media
/DATA/AppData/<app>

So rather than redirecting apps to /mnt/..., use /DATA/... for stable, expected behaviour.

Notes:

The external storage media path will be in /media folder by default.