Skip to content

Volumes

Overview

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.

Usage

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.

Mount Type

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 /mnt, /media, /srv, /opt can be added for security reasons. When using other providers, a mount point is created under /mnt/volumes.

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. Use the No-op provider if you want to add an /etc/fstab entry.

CIFS

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.

EXT4

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 blkid or lsblk to get the UUID of the disk.

Filesystem

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.

Filesystem (mountpoint)

When using the mountpoint mount type, Cloudron will not configure the server to mount the mount point. You have to set up /etc/fstab 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 mount flags.

NFS

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 circumvent this.

SSHFS

The SSHFS mount type is used to mount a file system over SSH (using the SFTP protocol).