FS Mount

All Plugins / Meta / Mount

Identity Card

StatusCore
Plugin LabelFS Mount
Short DescriptionMount a remote location on the file system before accessing the workspace
Plugin Identifiermeta.mount
AuthorCharles du Jeu
Urldocs/references/plugins/meta/mount
Dependencies

Documentation

Linux Only : Generic purpose meta plugin that is triggered before the repository is opened, and can be configured to mount any filesystem and unmount it when the user either switch to another repository or logs out.

Update: version 6.2.1
Due to security reason, we removed 'sudo' parameter on version 6.2.0 and use 'udevil' as an alternative. udevil is a command line program which mounts and unmounts removable devices without requirement of 'sudo'. For more information: https://ignorantguru.github.io/udevil/

Installation
Debian 8 / Ubuntu 14:
sudo apt-get install udevil

CentOS/RedHat:
Can use self-extracting installer: bash udevil-x.x.x-installer.sh See: https://ignorantguru.github.io/udevil/

After installation, you can configure udevil in /etc/udevil/udevil.conf to allow mount points and protocols
Testing by using command to mount in terminal
udevil mount smb://pydio@192.168.0.3/share /media/test/abc
then:
udevil umount smb://pydio@192.168.0.3/share /media/test/abc
Note: Make sure that the permission of mount point should be owned by apache when you test from Pydio.
Warning: Passing password via system evr PASSWD is not supported in 'udevil'.


Configuration to mount samba with udevil

Version 6.0.8

If you have permissions issues, you can use the "sudo" parameter to sudo all system operations. In that case, make sure to set the sudoers permission accordingly: apache user (www-data or httpd generaly) must be allowed to perform a mount operation using sudo.

To strengthen the security, use the parameter to pass password via the system environment and not via the command line itself. Sudo file must also be adapted to be allowed for that ( something like defaults@pydio-*-app* env_keep += "PASSWD").

Instance parameters

LabelDescriptionTypeDefault
FS Type *
FILESYSTEM_TYPE
Filesystem Type, will be used for the -t option of the mount commandStringcifs
Devil *
MOUNT_DEVIL
Call the mount/umount commands through devil, must be configured on the serverBooleanfalse
Remote Path *
UNC_PATH
Path to the remote share to mount, use //123.456.789.654/path you can use AJXP_USERString
Mount Point *
MOUNT_POINT
Mount Path, use AJXP_USERString
Mount Options
MOUNT_OPTIONS
Used with the -o command option, use AJXP_USER, AJXP_PASS, AJXP_SERVER_UID, AJXP_SERVER_GIDStringuser=AJXP_USER,pass=AJXP_PASS,uid=AJXP_SERVER_UID,gid=AJXP_SERVER_GID
Pass Password via environment instead of command line
MOUNT_ENV_PASSWD
Instead of setting password through the AJXP_PASS variable in mount options, pass it through the environment variables. Sudo file must be changed accordingly.Booleanfalse
Additional result codes to accept as success
MOUNT_RESULT_SUCCESS
On some setup result code 32 is often an already mounted code and we want to consider this as a success. Add comma-separated list of codes.String32
Remove mount point on unmount
REMOVE_MOUNTPOINT_ON_UNMOUNT
Delete mount folder on unmount. Can be required for security reasons.Booleanfalse
User Credentials
*
USE_AUTH_STREAM
Hiddentrue
User
USER
User name - Can be overriden on a per-user basis (see users 'Personal Data' tab)String
Password
PASS
User password - Can be overriden on a per-user basis.Password
Session credentials
USE_SESSION_CREDENTIALS
Try to use the current Pydio user credentials for connecting. Warning, the AJXP_SESSION_SET_CREDENTIALS config must be set to true!Booleanfalse

User-specific

LabelDescriptionTypeDefault
User
USER
User nameString
Password
PASS
User passwordPassword