LRR for Windows (Win10)

Download a Release

You can directly install LANraragi from the Microsoft Store. This will install the latest release.
ms-windows-store://pdp/?productid=XP9K4NMNPDMH6L
As an alternative, you can always download the latest Windows MSI Installer on the Release Page.
Windows Nightlies are available here.

Installation

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 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.
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.
You don't need to install a distribution through the Windows Store, as that is handled by the LRR installer package.
Once the install completes properly, you'll be able to launch the GUI from the shortcut in your Start Menu:

Installation on Windows 10 1809 (LTSC)

Recent MSI packages don't install on 1809 anymore due to underlying changes to make the installer lighter, but you can still sideload the latest server version on top of an old 0.7.9 install.
This method shouldn't break in the foreseeable future, but as the Win32 bootstrapper will still be the 0.7.9 version, you might lose out on future functionalities later on. You might want to consider switching to a source install on top of a Debian WSL distro you'd maintain yourself.
  1. 1.
    Install 0.7.9 like normal, this is mostly done to get the Win32 UI application installed on to your taskbar, we'll install the updated Linux image next.
  2. 2.
    If you started the service and the Windows application, make sure to close BOTH.
  3. 4.
    Open the MSI file in 7zip, and extract the "package.tar" file, which is the underlying Linux image
  4. 5.
    Download LxRunOffline and put it in the same directory as the "package.tar" file you just extracted
  5. 6.
    Uninstall the old Linux image from 0.7.9 with the following command, make sure to have your command window opened as administrator: lxrunoffline ui -n lanraragi
  6. 7.
    install the new image: lxrunoffline i -n lanraragi -d "C:\Users\*your user name*\AppData\Roaming\LANraragi\Distro\rootfs" -f LANraragi.tar Note: the name of the install HAS to be "lanraragi", do not change this on the -n argument
  7. 8.
    Start the application again, and you should see that it now shows the newest version of the server

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.
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.

Usage

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.

Updating

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.

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:
1
msiexec /i "lanraragi.msi" /l*v "install.log"
Copied!
and open a GitHub issue with it.

Server isn't available on localhost:3000 even though it has started properly

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.
Last modified 10d ago