Skip to content

Add ons feature : mounting drives

Alexandre edited this page Apr 15, 2023 · 5 revisions

Most add-ons include a specific code that allows mounting local or smb drives.

Local drives mount

Add-ons that support this option have the localdisks option.

How to fill option

Write the hardware name of your drive to mount, or its label. Several drives can be mounted, each one must be separated by a comma.

Exemple: localdisks: sda1, sdb1, MYNAS

How to use mounted drive

The drive will be mounted on /mnt/DISKNAME. DISKNAME represents the hardware name or label, as encoded in the localdisks option. The precise mount location will be described in the log.

Exemple: /mnt/MYNAS

Limitations

Container based mount

This drive is only mounted within the addon. It won't be available to other add-ons as long as you don't mount it.

Supported file systems

  • Full support : fat32, ext3, ext4
  • Partial support : exfat, vfat, msdos, ntfs (permissions and ACL don't works and this is an EXPERIMENTAL support)

Supported hardware devices

"/dev/ttyUSB0", "/dev/sda", "/dev/sdb", "/dev/sdc", "/dev/sdd", "/dev/sde", "/dev/sdf", "/dev/sdg", "/dev/nvme", "/dev/nvme0n1p1", "/dev/nvme0n1p2", "/dev/mmcblk", "/dev/fuse", "/dev/sda1", "/dev/sdb1", "/dev/sdc1", "/dev/sdd1", "/dev/sde1", "/dev/sdf1", "/dev/sdg1", "/dev/sda2", "/dev/sdb2", "/dev/sdc2", "/dev/sdd2", "/dev/sde2", "/dev/sdf2", "/dev/sdg2", "/dev/sda3", "/dev/sdb3", "/dev/sda4", "/dev/sdb4", "/dev/nvme0", "/dev/nvme1", "/dev/nvme2"

SMB drives mount

Add-ons that support this option have the networkdisks option.

How to fill options

  • networkdisks: "//SERVER/SHARE" # optional, list of smb servers to mount, separated by commas
  • cifsusername: "username" # optional, smb username, same for all smb shares
  • cifspassword: "password" # optional, smb password
  • cifsdomain: "domain" # optional, allow setting the domain for the smb share
  • smbv1 : obsolete, the code will automatically try to connect with several smb versions, starting from the most secure

How to use mounted drive

The drive will be mounted on /mnt/DISKNAME. DISKNAME represents the last folder in the smb mount. The precise mount location will be described in the log.

Exemple: //192.1.1.1/NAS/MYNAS is mounted in /mnt/MYNAS

Limitations

Container based mount

This smb mount is only mounted within the addon. It won't be available to other add-ons as long as you don't mount it.

Limitations on some virtual machines

Some virtual machines limit access to external network