Apps on Cloudron are containerized and do not have access to the server's file system. To provide an app access to a path on the server, one can create a Volume and then mount the volume into the app.
Volumes can be added in the
Volumes view. Click the
Add Volume button to add a volume and select the mount type.
Once added, the volumes can be mounted into one or more apps in the configuration page of the app. When mounting into an app, you can specify if it should be read-only or not.
Volumes are not backed up
Volumes are not backed up. Restoring an app will not restore the volume's content. Please make sure to have a suitable backup plan for each volume.
Cloudron supports a variety of mount types. When using a mount type other than
No-op, Cloudron will setup systemd mount config files
to automatically mount on server start up.
When using the
No-op type, only paths under
/opt can be added for security reasons. When using other providers,
a mount point is created under
Do not create fstab entry
When using the NFS/EXT4/CIFS/SSHFS providers, do not add an entry in
/etc/fstab because Cloudron will already set up the mount via systemd.
No-op provider if you want to add an
The CIFS mount type is used to mount CIFS shares. Note that, unlike EXT4 and NFS mount types, CIFS does not have a concept of users and groups. This makes it unsuitable for use as an app's data directory but will work fine for volumes and backups.
The EXT4 mount type is used to mount external hard disks or block storage. To add an external EXT4 disk, first make sure the
disk is formatted as EXT4 using
mkfs.ext4 /dev/<device>. Then, run
lsblk to get the UUID of the disk.
The Filesystem type is used for giving apps access to directories on the server. These are just directories on the local
filesystem and do not require any mounting configuration. We recommend giving this directory
chmod 777 permissions for
maximum compatibility across apps.
When using the
mountpoint mount type, Cloudron will not configure the server to mount the mount point. You have to set up
or systemd mount config files on your own. Use this if you want to set up an unsupported mount type or want to add specialized
The NFS mount type is used to mount NFS shares. If you need help setting up an NFS server, see this article.
By default, NFS shares will change the root user to be owned by the
nobody user. This is done for security purposes since it
prevents creating files with setuid bit set. You can add
no_root_squash to the options in the NFS server's exports file to
The SSHFS mount type is used to mount a file system over SSH (using the SFTP protocol).
Volumes can be remounted using the
Remount Volume button. This is useful in situations where a networked volume got disconnected.