Skip to content

Volumes

Overview

Volumes are local or remote file systems. They can be used as an app's main data storage or as a shared storage location between apps.

Add

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 either be used as an app's data directory or be mounted into one or more apps.

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. These mount points are created under /mnt/volumes.

Do not create fstab entry

When using the NFS/EXT4/CIFS/SSHFS/XFS 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.

Noop

When using the No-op type, only paths under /mnt, /media, /srv, /opt can be added for security reasons.

SSHFS

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

XFS

The XFS mount type is used to mount external hard disks or block storage. To add an external XFS disk, first make sure the disk is formatted as XFS using mkfs.xfs /dev/<device>. Then, run blkid or lsblk to get the UUID of the disk.

Remount

Volumes can be remounted using the Remount Volume button. This is useful in situations where a networked volume got disconnected.

File manager

The File Manager can be used to access the volume's file system from the browser. Use the File Manager button to open the File Manager:

Clicking the icon will pop up a new window. Note that there are action like Rename, Delete, Change Ownership in the context menu.