Install Cozy Drive desktop client on GNU/Linux

Download link (AppImage):

Actively supported distributions:

Distribution (64bits only) Comment
Ubuntu 23.04 (Lunar Lobster) Requires libfuse2
Debian 12 (Bookworm)
Linux Mint 21.2 (Victoria)
Fedora 38
Arch Linux up to date

Complete list of tested distributions

Archlinux : it is possible to install Cozy Drive present in the [community] repository:cozy-desktop

If your distribution is not supported, you can try the manual build guide.

How To:

To make Cozy Drive easier to use on any distribution, we distribute the application in AppImage format. This way you don't have to install anything, just download the app and run it.


Cozy Desktop requires libfuse2to work. Please install it using your preferred package manager.

For Ubuntu:

sudo apt install libfuse2

Method 1: Complete installation with system integration

This installation method provides the following advantages:

  • launch Cozy Desktop via the application launcher
  • open a .cozy-note directly from your file explorer
  • start synchronization automatically as soon as the PC starts (it is possible to deactivate this behavior in the app preferences)

Installation procedure :

  1. Install and launch appimaged (if necessary, adapt the installation directory in yellow below) :
mkdir -p ~/Applications
       wget -c$(wget -q -O - | grep "appimaged-. *-x86_64.AppImage" | head -n 1 | cut -d '"' -f 2) -P ~/Applications/
       chmod +x ~/Applications/appimaged-*.AppImage   ~/ Applications
/appimaged-* .AppImage

2. download the appimage file and drop it into the directory~/Applications/

Note: this installation may, in certain cases, display a warning / error message. This has no impact on the proper functioning of Cozy Drive.

Method 2: Simple installation without system integration

Installation procedure :

  • Download Cozy Drive: Cozy Drive for GNU/Linux 64-bit
  • Navigate to the folder where the file was downloaded
  • Move the file to a folder dedicated to AppImage applications (optional)
  • Modify the file properties to make it executable: right click on the application and select Propertiesfrom the context menu:
Change app properties

Then go to the Permissionstab and check the box to make the application executable:

Allow application to launch

Cozy Drive is ready to use!

Access the application on GNOME

Starting with GNOME 3.26 and later, system tray icons have been removed. This is where you could see some apps running, including Cozy Drive.

To see Cozy Desktop, you will need to install and configure an extension such as AppIndicator and KStatusNotifierItem Support in order to see the Cozy Desktop application when it is running.

That's all. You can now double-click the app to launch it and connect it to your Cozy. Have fun!

Access the application on i3wm

Open ~/.cozy-desktop/config.json, and set "gui" : {"visibleOnBlur" : true}so that the popover is not hidden by other windows.