pve-leilfs

LeilFS integration for Proxmox VE

This plugin enables native support for LeilFS as a storage backend in Proxmox VE.

⚠️ Disclaimer

This project is under active development but should still be considered beta. ⚠ Keep backups of your data.

📷 Preview

✨ Features

• Native LeilFS support in Proxmox VE
• Support for LeilFS clusters with custom ports and subfolders
• Live VM migration across Proxmox hosts thanks to shared storage support
• Flexible content types: Supports disk images, containers (LXC), ISOs, templates, and backups
• Multiple formats: Supports raw, qcow2, and vmdk image formats

🚀 Installation & Usage

Prerequisites

• Proxmox VE 9.0 or newer
• LeilFS/SaunaFS client (sfsmount) installed on all Proxmox nodes

Option 1: Easy Install

1. Upgrade to Proxmox 9.0
2. Download and install the .deb package from the Releases page.

Option 2: Manual Build

1. Upgrade to Proxmox 9.0

2. Clone this repository:

   git clone https://github.com/leil-io/pve-leilfs.git
   cd pve-leilfs

3. Build the package:

   dpkg-buildpackage -b -uc -us

4. Install it:

   dpkg -i ../libpve-storage-custom-leilfs-perl_0.1.1_all.deb

🖥️ Mounting LeilFS Storage

Via GUI

1. Open the Proxmox Web Interface
2. Navigate to Datacenter → Storage
3. Click Add → LeilFS and complete the wizard

Via Command Line

pvesm add leilfs <storage-name> --lfsmaster <IP/Hostname> --path <local-mount-path>

Optional parameters:

• --lfsmaster <hostname> — specify the LeilFS metadata server.
• --lfsport <port> — custom master port (default is 9421).
• --lfssubfolder <folder> — mount a specific subfolder rather than the root.
• --lfsoptions <options> — additional mount options for sfsmount.

Changelog

v0.1.1 – Initial Release

• Core features implemented
• leilFS mount/unmount and shared storage setup