This guide is intended for installing RetroNAS on an already configured Unraid server. If you're not familiar with Unraid or RetroNAS, head over to the RetroNAS GitHub page to learn about RetroNAS and consider setting it up on a Raspberry Pi.
Within Unraid, enable NFS by going to Settings
and NFS
.
- Enable NFS:
Yes
- Click
Apply
Create a new share in Unraid and call it retronas
(case sensitive).
Use your desired settings for Allocation method, minimum free space, included disks, and excluded disks.
Select No
for cache pool setting.
Make sure the following is set for NFS Security Settings:
- Export:
Yes
- Security:
Private
- Rule:
retronas.local(sec=sys,rw,async,no_root_squash)
Note: You can replace retronas.local with a static IP or different hostname if desired
Make sure the following is set for SMB Security Settings:
- Export:
No
- Case-sensitive names:
Auto
- Security:
Private
Download the Latest version of Debian 64-bit and upload it to your isos
folder in Unraid.
Click Add VM
under the VM tab in Unraid and choose Debian
from the list.
Keep all settings default but change the following:
- Logical CPUs:
2
- Initial Memory:
2048 MB
Max Memory2048 MB
- OS Install ISO: Select the Debian ISO uploaded to
isos
folder - Primary vDisk Size:
20G
Once the VM setup is done run the VM and launch the VNC Remote window. Install Debian with default settings.
- Hostname:
retronas
- Domain Name: Leave Blank
- Choose a username (
retronas
) and password (retronas
) for RetroNAS. This will also be used when devices connect to the RetroNAS server. - Partitioning Disks
Guided - use entire disk
and use default settings (expert Linux users can usemanual
) - Choose the default package manager
- Select only
Standard system utilities
under Software Selection. - Once Debian install completes, shut the VM down and remove the install iso, then start the VM again.
Log into Debian with the username and password created during the install.
- Log in the root user using
su -
- Enter a new root password
- Install sudo
apt update && apt install -y sudo nfs-common avahi-daemon
- Add retronas user to the sudoers group
usermod -aG sudo retronas
- Enter the command
exit
to logoff of the root user. - Enter the command
exit
again to logoff of the retronas user. - Log back into the retronas user.
sudo nano /etc/network/interfaces
Note: replace nano with your editor of choice, e.g., vi or nano- Edit
iface enp2s0 inet dhcp
toiface enp2s0 inet static
Note: Interface name may differ, e.g., enp2s0 - Configure a static IP address:
address 192.168.1.35
- Add a subnet mask:
netmask 255.255.255.0
- Set up a default gateway:
gateway 192.168.1.1
- Add DNS servers:
dns-nameservers 192.168.1.1 1.1.1.1 8.8.8.8
iface enp2s0 inet static
address 192.168.1.35
netmask 255.255.255.0
gateway 192.168.1.1
dns-nameservers 192.168.1.1 1.1.1.1 8.8.8.8
- Press Control-X to save the file and close nano.
- Type
sudo reboot
to restart the VM.
- Create the mount directory:
sudo mkdir /mnt/retronas
- Edit fstab:
sudo nano /etc/fstab
Note: replace nano with your editor of choice, e.g., vi or nano - Add the following line to the end of fstab:
tower.local:/mnt/user/retronas /mnt/retronas nfs nfsvers=3,rw 0 0
Note: Replacetower
with the name of your Unraid server or with a static IP if desired - Press Control-X to save the fstab file and close nano.
- Reload fstab
sudo mount -a
- Return to retronas user home folder:
cd ~
- Install curl:
sudo apt install -y curl
- Download RetroNAS installer:
curl -O https://raw.githubusercontent.com/danmons/retronas/main/install_retronas.sh
- Make the script executable:
sudo chmod a+x ./install_retronas.sh
- Run the install script:
sudo ./install_retronas.sh
- Run RetroNAS:
retronas
- Configure the RetroNAS top level directory to the UnRAID share
/mnt/retronas
- Configure RetroNAS as normal. Refer to the RetroNAS wiki for more information
unraid broken, requires guest agent to be installed to pick up IP address
not sure what to do . Even after installing guest agent it will not work.
Unraid app retronas made by space invader one