🪟
LRR for Windows (Win10)
You can directly install LANraragi from the Microsoft Store, using either this link: (paste in a browser window)
ms-windows-store://pdp/?productid=XP9K4NMNPDMH6L
Or through winget:
winget install lanraragi
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.
Simply execute the installer package. (The MS Store will do this for you if you went that way)
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.)
MS Store/winget installs will be installed to the default location. If you don't want the app to install in %AppData%, consider downloading the installer and running it manually.
Once the install completes properly, you'll be able to launch the GUI from the shortcut in your Start Menu:
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.
Tray GUI and Settings Window
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
Tray GUI and Log Console. Check that Dark Theme tho
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.
Updates have to be done manually by downloading and running the latest installer.
If you're using the MS Store, you can also update through it -- Keep in mind releases take usually a day or so to land on the store compared to direct downloads off GitHub.
Simply uninstall the app from Windows Settings.
Presto! Your database is not deleted in case you ever fancy coming back.
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:
msiexec /i "lanraragi.msi" /l*v "install.log"
and open a GitHub issue with it.
Running 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.