🪟LRR for Windows (Win10)
Download a Release
You can download the latest Windows MSI Installer on the Release Page.
The installer will tell you about this anyways, but LRR for Windows requires the Windows Subsystem for Linux to function properly.
Read the tutorial here to see how to enable WSL on your Windows 10 machine.
WSL defaults to WSL2, so if the installer doesn't work properly make sure you have virtualization enabled as well, or switch to WSL1. (wsl --set-default-version 1)
You don't need to install a distribution through the Windows Store, as that is handled by the LRR installer package.
Windows Nightlies are available here.
Installation
Simply execute the installer package.
You might get a SmartScreen prompt from Windows (doesn't seem to happen with the Store) as the installer isn't signed; These are perfectly normal. (If you're wondering why I don't sign installers, this article is a good read.)
Once the install completes properly, you'll be able to launch the GUI from the shortcut in your Start Menu:
Configuration
Starting the GUI for the first time will prompt you to setup your content folder and the port you want the server to listen on. The main GUI is always available from your Taskbar.
You can also decide whether to start the GUI alongside Windows, or start LRR alongside the GUI. Combining the two makes it so that LANraragi starts alongside Windows. 🔥🔥🔥
On Windows, VeraCrypt encrypted drives are known to not work properly as the content folder. See https://github.com/Difegue/LANraragi/issues/182 for details.
You can choose whether to use WSL1 or WSL2 to run the server as well - I recommend WSL1 as WSL2 is:
slower overall with NTFS filesystem access
non-functional when it comes to file watching -- You will have to use the "Rescan content folder" button instead every time you add new archives.
requires Hyper-V to be installed and active
Usage
Once the program is running, you can open the Web Client through the shortcut button on the user interface. You can also toggle the Log Console on/off to see what's going on behind the scenes.
Updating
Updates have to be done manually by downloading and running the latest installer.
Uninstallation
Simply uninstall the app from Windows Settings. Presto! Your database is not deleted in case you ever fancy coming back.
Troubleshooting
Installer failures
If the installer fails, it's likely because it can't enable the Windows Subsystem for Linux (WSL) on your machine. Try running through the official Microsoft installation guide depicted here.
If WSL is installed properly but the tray GUI reports LANraragi as not being installed, try using the wslconfig.exe /l command and make sure the "lanraragi" distribution is present.
The tray GUI will show the error message it encountered instead of the LRR Version number if it fails to detect the distro - This might help you troubleshoot further.
Some users reported that antivirus software can block the WSL distro install portion of the installer, so you might have some luck temporarily disabling it.
If you're still getting installer failures past that, try generating a full log of the installer:
and open a GitHub issue with it.
Server isn't available on localhost:3000 even though it has started properly
localhost:3000 even though it has started properlyRunning the application as Administrator might fix this in some instances.
Otherwise, make sure the Windows Firewall isn't blocking any perl process.
WSL2 uses a different network stack and can help if all else fails, although enabling it will likely make the server unreachable from remote machines.
Last updated
