This article is not perfect and not finished. If you have any questions or problems, please open a topic in the forum. Hints, comments or examples are welcome here in the forum.
“External” directories can be mounted and used in the virtual file system (VFS) of EGroupware/File Manager.
Examples of use:
- Home directory of fileserver/domaincontroller => Home directory EGroupware-user
- Department directory fileserver => EGroupware group directory
- Directories from the family NAS
- “local” directories of the EGroupware host => EGw file system
Mounted can be
- SMB shares (from file servers (Windows/Samba), NAS, …)
- FTP shares
- WebDAV shares (from other file sharing systems, other EGroupware instances, …) (from 21.1)
- local directories of the host system (also mounted there)
The following documentation describes how to mount an SMB share. Further examples with other protocols will follow.
Since maintenance release 21.1.20210923 it is possible to create SMB and WebDAV mounts directly in EGroupware:
The mount points are written into the database via command line. This must take place within the EGroupware container for standard Docker installations.
To mount a share in directory:
docker exec -it egroupware /usr/share/egroupware/filemanager/cli.php mount --user root_admin --password 'PWAdminuser' smb://user:password@SMB-Server/share /home/group/directory.
Or enter the container first:
docker exec -it egroupware bash
and then mount the directory
/usr/share/egroupware/filemanager/cli.php mount --user root_admin --password 'PWAdminuser' smb://user:password@SMB-Server/share /home/group/directory
docker exec -it egroupware (bash).
In the Docker container
egroupware execute the following command (or come to the command line).
Call from the file manager cli.php with paratemeter mount (to unmount:
Specify EGroupware Setup user. Mandatory prefix
root_. User is usually called admin.
Password of the EGroupware setup user.
Specify the share with user and password
Specification of the directory to be mounted. The directory must not exist!
User and password are stored as plain text in the EGroupware database!
To mount home directories:
docker exec -it egroupware /usr/share/egroupware/filemanager/cli.php mount --user root_admin --password ‘PWvonadmin’ ‘smb://$user:$pass@server/$user’ /home/$user/own files
Will be replaced by the logged in EGroupware user when mounting.
Will be replaced by the user’s password from the EGroupware database (in case of local user database) when mounting.
The share with the home directory of the file server
Mounted in the user’s home directory with the same name.
User and password are NOT stored as plain text in the EGroupware database. The encrypted one is used.
Such a mount then applies/functions for all users and therefore only has to be executed/entered once.
1. mounting a directory from a NAS with family videos.
The videos can then be accessed locally via PC/TV and also externally via EGroupware. Integrated and secure.
root@egw201deb:~# docker exec -it egroupware bash
root@ca2ebdd9c019:/# /usr/share/egroupware/filemanager/cli.php mount --user root_admin --password 'PWAdminuser' 'smb://UseronNAS:PWUseronNAS@server/share' /home/familygroup/NAS_Video
Root access granted!
smb://UseronNAS:PWUseronNAS@192.168.178.21/Video/DDTwonky_Video successfully mounted to /home/familygroup/NAS_Video
Or in one step:
docker exec -it egroupware /usr/share/egroupware/filemanager/cli.php mount --user root_admin --password 'PWvonadmin' smb://UseronNAS:PWUseronNAS@192.168.178.21/Video/DDTwonky_Video /home/familygroup/NAS_Video
2. mounting home directories (own files etc.) of a (company) file server.
The home directory is thus accessible from the stationary PC in the company as well as externally via the EGroupware file manager.
docker exec -it egroupware /usr/share/egroupware/filemanager/cli.php mount --user root_admin --password 'PWfromadmin' 'smb://$user:$pass@server/$user' /home/$user/Own files
Certain characters in the password require an apostrophe ’ around the password: & (more?)
The target directory must not exist.
Mounted directories are unmounted with
umount (same command as above).
Admin/Clear Cache and Register Hooks must be executed. Only then is the folder visible in the file manager.
The speed of file access depends very much on the entire chain. Especially the access to a slow NAS can be clearly noticeable in the EGroupware file manager.
If one enters a directory with a mounted directory, EGroupware tries to access the directory before the content is displayed. This can lead to delays or even become a problem if the share is not accessible.
The directories mounted in EGw are also accessible via WebDAV.
With Collabora Online, files from mounted directories can also be edited. However, simultaneous editing via EGw and file server are technically mutually exclusive. Caution: No locking!
The access rights must be set correctly throughout the entire chain.
Ideally, EGw and the file server should work with the same user database. This ensures that access takes place with the correct password. Even if the password is changed once on the file server. EGroupware can be connected via AD or LDAP, for example.
Documentation / Links:
We offer technical and organisational support on this topic through our commercial support:
Or simply send an e-mail to firstname.lastname@example.org or customers simply open a ticket in our ticket system.
For questions, suggestions, etc., please create a separate topic in the forum as always and refer to this article.