LANraragi
GithubDemoDocker HubDiscord Server
Nightly Release
Nightly Release
  • LANraragi Documentation
  • Installing LANraragi
    • ❓Which installation method is best for me?
    • 🪟LRR for Windows (Win10)
    • 🍎Homebrew (macOS)
    • 🐳Docker (All platforms)
    • 🛠️Source Code (Linux/macOS)
    • 🐧Community (Linux)
    • 👿Jail (FreeBSD)
  • Basic Operations
    • 🚀Getting Started
    • 📚Reading Archives
    • ✒️Adding Metadata
    • 🔎Searching the Archive Index
    • 📈Statistics and Logs
    • 🖌️Themes
  • Advanced Usage
    • 🦇Batch Operations
    • 📂Categories
    • ⬇️Downloading Archives
    • 💾Backup and Restore
    • 📱Using External Readers
    • 🌐Network Interface Setup
    • 🕵️Proxy Setup
    • 📏Tag Rules
  • Developer Guide
    • 🏗️Setup a Development Environment
    • 🏛️Architecture & Style
    • 🈁Translating LANraragi to other languages
  • API Documentation
    • 🔑Getting started
    • Search API
    • Archive API
    • Database API
    • Category API
    • Tankoubon API
    • Shinobu API
    • Minion API
    • Miscellaneous other API
  • Writing Plugins
    • 🧩Getting started
    • Login Plugins
    • Metadata Plugins
    • Downloader Plugins
    • Generic Plugins ("Scripts")
    • Code Examples
Powered by GitBook
On this page
  • Download a Release
  • Installation
  • Configuration
  • Usage
  • Updating
  • Uninstallation
  • Troubleshooting
  • Installer failures
  • Server isn't available on localhost:3000 even though it has started properly

Was this helpful?

  1. Installing LANraragi

LRR for Windows (Win10)

PreviousWhich installation method is best for me?NextHomebrew (macOS)

Last updated 1 year ago

Was this helpful?

Download a Release

You can download the latest Windows MSI Installer on the .

The installer will tell you about this anyways, but LRR for Windows requires the Windows Subsystem for Linux to function properly. Read the tutorial 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 .

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

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

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.

On Windows, VeraCrypt encrypted drives are known to not work properly as the content folder. See for details.

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 .

🪟
https://github.com/Difegue/LANraragi/issues/182
here
Release Page
here
here
this
Tray GUI and Settings Window
Tray GUI and Log Console. Check that Dark Theme tho ‍