MooseFS integration for Proxmox VE
This plugin enables native support for MooseFS as a storage backend in Proxmox VE.
This project is highly experimental.
⚠️ Do NOT use snapshots in MooseFS block device (bdev) mode. They are currently unsafe and may result in data loss. Snapshot support is still under active development and will remain experimental until this warning is removed.

- Native MooseFS support in Proxmox VE
- Support for MooseFS clusters with passwords and subfolders
- Live VM migration across Proxmox hosts with MooseFS-backed storage
- Clean unmounting when MooseFS storage is removed
- MooseFS block device (
mfsbdev
) support for high performance
- Instant snapshots and rollbacks
- Instant cloning
- Proxmox VE 8.4.1 or newer
- Upgrade to Proxmox 8.4.1
- Download and install the
.deb
package from the Releases page.
-
Upgrade to Proxmox 8.4.1
-
Clone this repository:
git clone https://github.com/yourusername/pve-moosefs.git cd pve-moosefs
-
Build the package:
make
-
Install it:
dpkg -i *.deb
- Open the Proxmox Web Interface
- Navigate to Datacenter → Storage
- Click Add → MooseFS and complete the wizard
pvesm add moosefs moosefs-vm-storage --path /mnt/mfs
This command creates a custom storage named moosefs-vm-storage
using the MooseFS plugin.
--mfsmaster <hostname>
— specify the MooseFS metadata server--mfspassword <password>
— use if your MooseFS export requires authentication--mfssubfolder <folder>
— mount a subfolder rather than the root of the MooseFS volume--mfsport <port>
— coming soon 🚧
Contributors:
- @anwright — major fixes, snapshots, and cleanup
- @pkonopelko — general advice and support
Inspiration and references (for plugin skeleton and packaging):
- mityarzn/pve-storage-custom-mpnetapp
- ServeTheHome Forums
- Official Proxmox GlusterFS and CephFS storage plugins
- Improvements to LXC snapshot support
- Reduced debugging log noise
- Multiple small and defensive fixes
- Improved support for LXC
- Enhancements for live migration, unmapping, and cloning
- Full support for MooseFS block device (
mfsbdev
)
- Basic
mfsbdev
support added
- GUI support for container storage
- Allowed leading
/
inmfssubfolder
paths
- Core features implemented
- MooseFS mount/unmount and shared storage setup
- Snapshots not functional in this version