Install Filarr
Download and install Filarr on Windows or Linux, or open it in your browser. Updates, uninstalling and where your data is stored.
On this page
Documentation sections
Filarr comes as a desktop app for Windows and Linux, and as a web app you open in your browser. This article shows how to install the desktop app, how it stays up to date, where it keeps your data and how to remove it.
Choose how to use Filarr
| You use | What to do |
|---|---|
| Windows | Install the desktop app from https://filarr.com/download |
| Linux | Download the desktop app (an AppImage file) from https://filarr.com/download |
| Any computer, without installing anything | Open the web app at https://app.filarr.com |
| A Mac | The desktop app is not available on Mac yet. Use the web app in the meantime |
The desktop app and the web app open the same account, the same files and the same notes. Desktop and web: what differs lists what each one can do.
System requirements
| Windows | Linux | |
|---|---|---|
| System | Windows 10 or later, 64-bit | Ubuntu 20.04 or later, Fedora 36 or later, Debian 11 or later, 64-bit |
| Memory | 4 GB | 4 GB |
Install on Windows
- Go to https://filarr.com/download. The page detects Windows and offers Download for Windows.
- Click it. Your browser downloads a file named Filarr-Setup, followed by the version number.
- Open the downloaded file.
- Follow the installer. You can choose the folder where Filarr is installed.
- Open Filarr with the shortcut the installer adds to your desktop and to the Start menu.
The first time, Filarr opens its setup wizard. Set up Filarr the first time walks you through it. The very first launch can take a little longer than the next ones, while Windows checks the new files.
Install on Linux
Filarr for Linux is an AppImage: a single file that runs without installation.
- Go to https://filarr.com/download and click Download for Linux. From another system, use the Linux tile under Other platforms. You get a file whose name ends in
.AppImage. - Allow the file to run as a program. In most file managers, right-click the file, open its properties, and in the permissions, tick the option that lets it run as a program. The exact words depend on your desktop.
- Double-click the file to start Filarr.
You can also do steps 2 and 3 in a terminal. Replace Filarr.AppImage with the exact name of the file you downloaded:
chmod +x Filarr.AppImage
./Filarr.AppImage
If nothing happens when you open the file, your system is probably missing FUSE 2, which AppImage files need. On Ubuntu or Debian, install the libfuse2 package (libfuse2t64 on Ubuntu 24.04 and later), then try again.
If the window flickers or stays black, see Troubleshooting: Filarr has display settings for Linux.
Use the web app instead
Nothing to install: open https://app.filarr.com in your browser. The first visit shows the same setup wizard as the desktop app. Use Filarr in your browser explains what to expect.
On a Mac
Updates
The desktop app updates itself. It checks for a new version a minute after it starts and then every four hours, downloads it in the background, and installs it when you quit Filarr.
When a new version is on its way, a message in the bottom right corner says that it is available, then shows Update ready. Click Restart to install it right away, or Later to keep working. It then installs the next time you quit.
To check right now, open Settings → About and click Check for updates.
The web app updates differently: a banner says A new version of Filarr is ready. Click Reload to use it.
Where your data is stored
| Where Filarr runs | Where your data lives |
|---|---|
| Windows | The filarr folder in your user's application data: %APPDATA%\filarr |
| Linux | ~/.config/filarr in your home folder |
| Web app | Inside your browser, for app.filarr.com |
Your files and notes are stored there encrypted. Do not move or edit these files by hand. To keep a copy of everything, use Settings → Storage & Data → Export all in the desktop app. See Export and back up everything.
Uninstall Filarr
On Windows
- In Windows, open Settings, then Apps.
- Find Filarr in the list of installed apps.
- Choose Uninstall and confirm.
On Linux
- Quit Filarr.
- Delete the
.AppImagefile.
Your data stays in ~/.config/filarr. Delete that folder only if you want to erase your local profiles for good, after making an export if you need one.