> For the complete documentation index, see [llms.txt](https://sugoi.gitbook.io/lanraragi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sugoi.gitbook.io/lanraragi/dev/installing-lanraragi/methods.md).

# Which installation method is best for me?

This is a by-OS breakdown of how you can install the software on your machine.

As LRR is a server app first and foremost, its setup is a bit more complex than your usual Desktop application.\
However, a lot of work as been done behind the scenes to make it easy!

Look at the methods below for something that fits your OS and usage.

## Linux/macOS: *Homebrew*

[Homebrew](https://brew.sh) allows you to quickly setup LRR on macOS and Linux without relying on containers or modifying your preinstalled system libaries.

![brew](https://3744230098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPbsOo9_KVq_qSlpg5H-3168184435%2Fuploads%2Fgit-blob-9ac55606b71cb1e803cc47f3efce6e05ef0da712%2Fbrew.jpg?alt=media\&token=2ee8af21-87a9-4e53-a355-d538e311e0da)

{% content-ref url="/pages/-Ls9S9K1Hme6WzcYEVBt" %}
[Homebrew (macOS)](/lanraragi/dev/installing-lanraragi/macos.md)
{% endcontent-ref %}

{% hint style="info" %}
While not a part of the main repo, you can check out the [Nix](/lanraragi/dev/installing-lanraragi/community.md) package as well if brew isn't to your taste.
{% endhint %}

## Windows 10/11: *LRR for Windows*

{% hint style="warning" %}
This method works on **64-bit** editions of Windows only.
{% endhint %}

![win10](https://3744230098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPbsOo9_KVq_qSlpg5H-3168184435%2Fuploads%2Fgit-blob-51b137f57b9d19b464400f3fb289b571c2f6217e%2Fkaren.png?alt=media)

I provide a dedicated installer for Windows machines as of 0.6.0, complete with a GUI and autostart.

{% content-ref url="/pages/-Lg3uISr-98RVrVr5x8d" %}
[LRR for Windows (Win10/11)](/lanraragi/dev/installing-lanraragi/windows.md)
{% endcontent-ref %}

## Linux/macOS/Windows: *Docker*

Taking a page from sysadmin books, you can easily install LRR as a **container** with Docker.\
They're lightweight, easy to update, and automatically built/tested. I recommend this for NAS setups!

{% content-ref url="/pages/-LQB9yWxC0HjCc\_2D5ex" %}
[Docker (All platforms)](/lanraragi/dev/installing-lanraragi/docker.md)
{% endcontent-ref %}

## Linux/macOS: *Installing from Source*

Installing from **source** is a more involved procedure, but it does put you in full control and able to hack up the app's files as you wish.

{% content-ref url="/pages/-LQB9yX0VLiElRynmo2x" %}
[Source Code (Linux/macOS)](/lanraragi/dev/installing-lanraragi/source.md)
{% endcontent-ref %}

## Linux/Community: *Community provided install packages*

Ready-to-install packages provided by voluntary maintainers or by a linux distribution itself.

{% content-ref url="/pages/-MO7WDgd0B65zXv4nfjw" %}
[Community (Linux)](/lanraragi/dev/installing-lanraragi/community.md)
{% endcontent-ref %}

## FreeBSD/Jail

Similar to installing from source with an altered process for FreeBSD compatability.

{% content-ref url="/pages/-MgHpLGmu91GGWDWyRvv" %}
[Jail (FreeBSD)](/lanraragi/dev/installing-lanraragi/jail.md)
{% endcontent-ref %}

## Windows 7 or 8: don't

![I really hope you guys don't do this](https://3744230098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPbsOo9_KVq_qSlpg5H-3168184435%2Fuploads%2Fgit-blob-3d7f815d0b55a13978320d850fb9188555415c1a%2Fshiggy.png?alt=media\&token=5f82a766-8dd5-479f-9218-76b9caaa01c8)

Switch to 10 or Linux.