2.6 KiB
Disk Management
The Controller provides tools for mounting and managing external drives and storage devices.
Supported Filesystems
The following filesystem types can be mounted:
- ext4 - Linux native filesystem (recommended)
- btrfs - Linux filesystem with advanced features
- vfat - FAT32, compatible with Windows/Mac
- exfat - Extended FAT, good for large files and cross-platform use
Viewing Disks
The disk management section shows all detected block devices and partitions:
| Column | Description |
|---|---|
| Device | Device path (e.g., /dev/sda1) |
| Size | Partition size |
| Filesystem | Detected filesystem type |
| Label | Volume label (if set) |
| Mount Point | Where the drive is mounted (if mounted) |
Mounting a Drive
- Locate the drive in the disk list
- Click the Mount button
- Optionally specify a custom mount point (must be under
/media) - The drive will be mounted and accessible
Default Mount Points
If no mount point is specified, drives are mounted under /media using the device name or label.
Filesystem Permissions
For exfat and vfat filesystems, the Controller automatically sets ownership to the wrolpi user
so files are accessible to WROLPi services.
Unmounting a Drive
- Find the mounted drive in the list
- Click the Unmount button
- The drive will be safely unmounted
Note: A drive cannot be unmounted if files are in use. Close any applications or processes using files on the drive before unmounting.
Persistent Mounts
Persistent mounts survive system reboots. The Controller manages these through the system's fstab configuration.
Making a Mount Persistent
- Mount the drive
- Enable the Persistent toggle for the mount
- The mount will be added to fstab and restored on reboot
Removing a Persistent Mount
- Disable the Persistent toggle
- The fstab entry will be removed
- The drive will not auto-mount on next boot
Protected Mount Points
The following system mount points cannot be modified:
/(root filesystem)/boot/boot/firmware
Attempting to unmount these will be blocked to protect system stability.
Mount Point Restrictions
For security, mount points are restricted to the /media directory. This prevents accidentally
mounting drives over system directories.
Docker Mode
In Docker deployments, disk mounting must be handled on the host system. The Controller can display disk information but cannot perform mount operations from within a container.