Deploying Unraid on Proxmox to manage storage can be a powerful setup, leveraging Proxmox’s virtualization capabilities and Unraid’s storage management features.
Step-by-Step Guide to Deploy Unraid on Proxmox
1. Prepare Proxmox Environment
-
Ensure Proxmox is Updated:
- Update your Proxmox installation to ensure you have the latest features and security patches:
apt update && apt full-upgrade -y
- Update your Proxmox installation to ensure you have the latest features and security patches:
-
Add a Storage Location for VM Images:
- Make sure you have a storage location available for your VM images, preferably on your ZFS pool.
2. Download Unraid
-
Get Unraid USB Creator:
- Download the Unraid USB Creator from the Unraid website.
-
Create Unraid Bootable USB:
- Use the Unraid USB Creator to create a bootable USB drive with the Unraid OS.
3. Create a Proxmox VM for Unraid
-
Create the VM:
- Navigate to
Datacenter
>Node
>Create VM
. - Name the VM (e.g.,
unraid
).
- Navigate to
-
Configure VM Settings:
- OS:
- Choose
Do not use any media
.
- Choose
- System:
- Set BIOS to
SeaBIOS
. - Set Machine type to
i440fx
.
- Set BIOS to
- Hard Disk:
- Do not add a hard disk at this stage.
- CPU:
- Assign the desired number of cores.
- Memory:
- Allocate sufficient RAM (e.g., 8GB).
- Network:
- Choose the
virtio
model.
- Choose the
- CD/DVD:
- Do not add any ISO image at this stage.
- OS:
-
Add the Unraid USB as a Hard Disk:
- After the VM is created, navigate to
Hardware
>Add
>USB Device
. - Choose the USB device where you installed Unraid.
- After the VM is created, navigate to
-
Add Physical Disks to the VM:
- Navigate to
Hardware
>Add
>PCI Device
. - Add the physical disks intended for Unraid as PCI devices.
- Navigate to
4. Modify VM Configuration for Unraid
- Edit the VM Configuration File:
- Access the VM configuration file located at
/etc/pve/qemu-server/<vmid>.conf
. - Add the following lines to ensure proper PCI passthrough and USB boot:
args: -device usb-host,hostbus=1,hostaddr=2 hostpci0: 00:1f.2
- Adjust the hostbus and hostaddr according to your USB device.
- Access the VM configuration file located at
5. Start the Unraid VM
-
Boot the VM:
- Start the Unraid VM from the Proxmox web interface.
- Ensure the VM boots from the USB drive.
-
Access Unraid Web Interface:
- Once Unraid boots up, access the Unraid web interface by navigating to the IP address assigned to the VM.
6. Configure Unraid
-
Set Up Unraid:
- Follow the initial setup wizard to configure Unraid.
- Assign the physical disks to the Unraid array and cache pool as desired.
-
Configure Network:
- Ensure that the network settings in Unraid match your Proxmox network configuration for seamless integration.
7. Optional: Enable GPU Passthrough
- Enable IOMMU in Proxmox:
- Ensure IOMMU is enabled in Proxmox as described earlier.
- Pass the GPU through to the Unraid VM by adding the GPU as a PCI device in the VM configuration.
Example Network Configuration
-
Proxmox Network Configuration:
- Create a Linux bridge (
vmbr0
) on Proxmox for VM networking. - Assign a static IP to Proxmox management interface.
- Example configuration:
auto vmbr0 iface vmbr0 inet static address 192.168.1.10/24 gateway 192.168.1.1 bridge_ports eno1 bridge_stp off bridge_fd 0
- Create a Linux bridge (
-
Unraid Network Configuration:
- Configure the network settings in Unraid to use the same bridge.
- Assign a static IP (e.g.,
192.168.1.20
).
By following this guide, you can deploy Unraid on Proxmox, leveraging both Proxmox’s virtualization capabilities and Unraid’s powerful storage management. This setup allows for efficient storage management and flexible virtualization solutions.