Changing default storage of Ludus to a NFS share.
ludus-with-nfs.md
edited
1To change the default storage for Ludus to your new NFS share, you need to perform two main steps: first, grant the necessary permissions in Proxmox, and second, update the Ludus configuration file.
2
3### ⚙️ Step 1: Grant Permissions in Proxmox
4
5Ludus users need to be able to access the new storage pool. You can set this up via the Proxmox command line.
6
71. Log in as `root` to your Proxmox host (or the node where the NFS storage is mounted).
82. Run the following commands, replacing `<your new storage>` with the **exact Storage ID** you created in Proxmox (e.g., `omv-nfs`):
9
10 ```bash
11 pveum acl modify /storage/<your new storage> -group ludus_users -role DatastoreUser
12 pveum acl modify /storage/<your new storage> -group ludus_admins -role PVEDatastoreAdmin
13 ```
14
15 > **Note:** The `DatastoreUser` role is generally sufficient for using the storage, while `PVEDatastoreAdmin` grants more extensive management permissions.
16
17### 📝 Step 2: Update the Ludus Configuration File
18
19Now, you need to tell Ludus to use this new storage pool by default.
20
211. Open the Ludus configuration file in a text editor (like `nano` or `vim`):
22 ```bash
23 sudo nano /opt/ludus/config.yml
24 ```
25
262. Find and modify the following parameters:
27 * **`proxmox_vm_storage_pool`**: Set this to the **Storage ID** of your NFS share (e.g., `omv-nfs`).
28 * **`proxmox_vm_storage_format`**: Set this to `qcow2`. This is the recommended and most compatible disk format for directory-based storage types like NFS.
29 * **`proxmox_iso_storage_pool`**: You can also set this to your new storage pool if you want to store ISO images there. Otherwise, leave it as `local`.
30
31 Your configuration should look similar to this:
32
33 ```yaml
34 proxmox_vm_storage_pool: omv-nfs
35 proxmox_vm_storage_format: qcow2
36 proxmox_iso_storage_pool: omv-nfs # Or keep as 'local' if preferred
37 ```
38
393. Save the file and exit the editor.
40
41### 🔄 Step 3: Restart Ludus Services
42
43For the changes to take effect, you must restart the Ludus services:
44
45```bash
46sudo systemctl restart ludus ludus-admin
47```
48
49After completing these steps, any new VMs or templates created by Ludus will automatically be stored on your NFS share.