Koofr Desktop Clients Help

Getting started

Koofr offers you an easy way of synchronizing data and accessing files and folders on remote systems via web application and a desktop client that you can install on your Windows, Linux or macOS system. The Desktop client allows you to automatically synchronize files/folders from your computer or access them directly from our application with ease. Create a simple two-way synchronization from your computer (Windows, macOS or Linux) with the help of the Koofr desktop client.

Installing the Koofr desktop clients

Installing the Koofr desktop client for Windows

To start accessing and synchronizing data on your remote computers, you must first install the Koofr desktop client for Windows.

To download the Koofr desktop client:

  • Sign-in to Koofr web application
  • In the Main menu on the left-hand side click on Link this computer
  • Click the Download button
  • This action will start the download of the Koofr desktop client for Windows
  • When the download completes, run the Koofr setup application by clicking on the downloaded .exe file.
  • Note: If you get the Windows User Account Control warning, click on Yes when prompted, to let Koofr install necessary components on your computer. If you get a safety warning from your anti-virus program, confirm the Koofr installer as safe.
  • When Koofr Setup window appears, click the Next button to go ahead with the installation
  • In Choose Components window you can choose Koofr components you want to install or uncheck the unwanted components and click Next
  • In Choose Start Menu Folder window, choose a Start Menu folder for the Koofr shortcuts or check the Do not create shortcuts checkbox
  • Click Install to complete the installation

Note: You can download the Koofr desktop client without the sign-in step here.

Installing Koofr desktop client for macOS

To start accessing and synchronizing data on your remote computers, you must first install the Koofr desktop client for macOS.

To download the Koofr desktop client:

  • Sign-in to Koofr web application
  • In the Main menu on the left-hand side click on Link this computer.
  • Click the Download button
  • This action will start the download of the Koofr desktop client for macOS
  • When the client download completes, run the Koofr setup application by opening Finder and dragging the Koofr icon into your applications folder.

Note: If you get a warning error message from your Mac, click on the Open button.

  • Follow the setup application instructions to complete the installation

Note: You'll get a warning error message from your Mac when you try to open the Koofr desktop client for the first time because the program wasn't downloaded from the Mac App Store/iTunes.

You solve this issue by opening Finder and clicking on the Applications on the left side of the window. Right-click on the Koofr desktop client icon and select Open. You'll need to confirm that you want to run a program that was downloaded from the Internet. You only need to do this the first time you are trying to open the Koofr desktop client.

Installing Koofr desktop client on macOS Catalina and macOS Mojave

Koofr desktop client is signed with Apple's certificate and can be installed on macOS Catalina. But, since Koofr desktop client is not downloaded from the Mac App store/iTunes you will need to manually allow our application to install.

In macOS Catalina and macOS Mojave, when an application fails to install because it hasn’t been notarized or is from an unidentified developer, it will appear in System Preferences > Security & Privacy, under the General tab. Click Open Anyway to confirm your intent to open or install the application.

Installing the Koofr desktop client for Linux

To start accessing and synchronizing data on your remote computers, you must first install the Koofr desktop client for Linux.

To download the Koofr desktop client:

  • Sign-in to Koofr web application
  • In the Main menu on the left-hand side click on Link this computer.
  • Click the Download button
  • This action will start the download of either Linux(64bit) or Linux(32bit) setup
  • When the download completes, run the Koofr setup package
  • Open the terminal, change directory to the extracted folder and install the Koofr client by typing ./installer.sh-

General Desktop Clients Help

How to start synchronizing data with Koofr?

The first synchronization has already been created for you as soon as you set up the Koofr desktop client. You will find a folder named Koofr on your desktop. Whatever you put into this folder will automatically be backed up to Koofr to a folder named My desktop sync. Your files will always be accessible through web and mobile applications. Read more about creating new syncs in How to create new syncs to Koofr.

Note for Windows users: If you are a Windows user and you get an Invalid filename syncing error you should rename the files you are trying to sync so they do not include characters that are incompatible with the Windows file system (< - less then, > - greater then, : - colon, " - double quote, | - vertical bar or pipe, ? - question mark, * - asterisk, . - period or a space at the end of a file/folder name).

How to create new syncs to Koofr?

You can create new syncs manually by opening Syncs in the menu on the left and clicking on Create new. You can select any folder on your computer and sync it to the selected folder on Koofr. This way, you can keep your files safe and still keep them in the desired location on your hard drive. You can add as many synchronizations as needed.

Note: It is not recommended to Sync your whole system drive (usually your C: drive) or any Windows/macOS/Linux system folders, because their change or deletion can lead to a system crash.

How to create Syncs across multiple devices?

If you need to keep the same files synchronized across multiple devices, you can simply make a sync on each device and point them all to the same folder on Koofr. Our software will automatically make sure all content is in sync everywhere, as soon as the computers come online. Be aware that the content that is already present in the folders you choose on your computer, will be copied to all the other computers as well.

How can I manage my Syncs?

You can check the info on your sync, pause synchronizing or remove it completely.

To pause Syncs:

  • Click on Syncs in the menu on the left
  • Click on the pencil icon in the top right corner of the sync you want to manage
  • Click the Pause button
  • You’ll see the status icon of the connection change to yellow and status will switch from to Paused.

To resume syncing, click the pencil icon in the top right corner of the sync and click on Resume to resume syncing.

To delete a Sync:

  • click the pencil icon in the top right corner of the Sync
  • click on Remove

To check the info on your Sync:

  • click the pencil icon in the top right corner of the Sync
  • You can see between which folders the synchronization is done
  • You can see the synchronized folder size
  • You can see the number of synchronized files

Access to files and folders on a remote computer

With Koofr you can effortlessly access files and folders on your remote computer. Additionally, you can also share and organize data you choose to remotely access.

To start remote access of files and folders:

  • Locate the Koofr client icon on your desktop and double-click on it
  • Click on Local Folders
  • Click on Connect a local Folder
  • When you connect a local folder, you will be able to access this folder from any device. No files will be transferred to Koofr. But, when this computer is offline your local folder will not be available.
  • Choose the existing folder you want to connect or create a new one and click Next
  • Enter a name under which the folder will appear in your Koofr account and click Next
  • Click Finish to confirm your action

You are now finished connecting a local folder. You can access this folder from any device with an Internet connection as long as the computer where the local folder is located is online. You can find the remote connection you created in the Koofr Main menu, under a name you selected in the process of creating the local folder.

Note: All changes you make on your chosen local folder, are made directly on your computer. Be careful when deleting files and doing other changes.

Note: The Local Folders option is only available in the paid Koofr accounts. You can read about upgrading your account in Upgrading my Koofr account and more about benefits of having a paid Koofr account in What benefits do paid accounts bring besides extra storage space?.

How to manage my Local folder connections?

You can pause the remote connection or disconnect it completely.

To pause the remote connection:

  • Click on Local folders in the menu on the left
  • Click on the pencil icon in the top right corner of the connection
  • Click the Pause button
  • You’ll see the status icon of the connection change to yellow and status will switch from Connected to Paused.

To resume syncing, click the pencil icon in the top right corner of the remote connection and click on Resume to switch the status back to Connected.

To disconnect the remote connection:

  • Click on Local folders in the menu on the left
  • Click on the pencil icon in the top right corner of the connection
  • Click the Disconnect icon and confirm by clicking on the Disconnect button
  • The local folder will be disconnected

You cannot change the path of the remote connection. You can create a new path and delete the previous one.

Note: The Local Folders option is only available in the paid Koofr accounts. You can read about upgrading your account in Upgrading my Koofr account and more about benefits of having a paid Koofr account in What benefits do paid accounts bring besides extra storage space?.

How do I map Koofr as a network drive?

The easiest and Koofr recommended way to setup Koofr as a network drive is by installing the Koofr desktop client and enabling the Network Drive in the desktop client Settings. This will take care of everything, from generating separate app password to mapping Koofr as a network drive on your computer. If you are an advanced user, you can also connect Koofr as a network drive manually on Windows, Linux and macOS.

Why I can't enable the Network drive in Koofr desktop client Settings?

If you already set up the WebDAV protocol manually, you will not be able to do it in the desktop client Settings.

I downloaded the desktop client but it does not show any of the cloud-based storage services I use. Why?

You cannot see the cloud-based storage services you use in the desktop client. You can connect them in the Main menu in the Koofr WebApp and see them there.

How can I use the desktop clients to edit the documents I have stored in Koofr?

First, you need to Enable the Network drive in Koofr desktop client Settings. Read more about it here. Mapping Koofr as a network drive allows you to access Koofr directly from your computer. Koofr will appear as a disk drive on your computer. This way you can edit documents on your computer, with your usual document editor and this will be directly reflected in Koofr WebApp.

How do I map Koofr as a network drive?

The easiest and Koofr recommended way to setup Koofr as a network drive is by installing the Koofr desktop client and enabling the Network Drive in the desktop client Settings. This will take care of everything, from generating separate app password to mapping Koofr as a network drive on your computer.

If you are an advanced user, you can also connect Koofr as a network drive manually. Read more about connecting Koofr as a network drive manually on Windows, Linux and macOS.

What is the SyncTrash folder that is automatically created inside Koofr folder?

When files are removed locally during synchronization, they are not deleted but moved into the SyncTrash folder. You can remove files from there whenever you wish if you are sure you do not need them anymore. SyncTrash is the Koofr version of cross OS compatible Recycle bin. It exist so users can avoid losing files when they accidentally deletes something on the server and sync deletes it locally afterwards. Files from SyncTrash are automatically deleted after 30 days.

I use Ubuntu 18.04 with Gnome Shell and Koofr icon has disappeared.Why?

Gnome Shell 2.26 removed support for App Indicator icons. Please install KStatusNotifierItem/AppIndicator Support Gnome extension to get the icons back.

What does enabling Sync icons in the Settings do?

The Koofr desktop app makes sure that the folders on your computer are synced with your Koofr WebApp. If you go into Settings, find Sync icons and press Enable, you will see the sync icons over the files that will tell you the status of the synchronization. The status is either synced, syncing or error, which is visible from the icon which appears over the files).

Note: When you enable Sync icons you need to reboot your computer for it to start working. This only works for Syncs. This is a Windows only feature.