File Sync

Working with files in Kahua just became a whole lot easier!  Users now have the ability to sync File Manager to a folder on their local machine.  Syncing will push physical files from Kahua to the user's PC or Mac, at which point the user can open and modify the file using its native application.  Once changes have been saved and the file closed, Kahua will sync the file back into the Kahua platform where it will be distributed to any other users who have also synced that project.  File sync is a great solution when working in areas that do not have an internet connection, since the files are stored locally on your machine, you do not need an active internet connection and can work on them offline.  Once reconnected, any changes will be pushed back into Kahua and files added by others will also be retrieved.  Kahua has also incorporated a file conflict checker to warn users in the event two users have modified the file at the same time.  If a conflict is detected, users will be given the option to create a new version of the file or discard their changes.  

File Sync is controlled by a new Role in the Groups app for File Manager called "Sync".  The Domain Admin and Domain Users groups have the role enabled by default.  This role will need to be enabled by an administrator for all other groups.  A Kahua Platform License is required to enable File Sync

Watch the demonstration on how to set up an use Kahua File Sync

File Sync best practices:

  • File Sync may impact system performance and bandwidth used based on the amount of files in the projects you have synced
  • Always map to a folder on your local drive; do not map to a network location; we recommend using either the native "Documents" or "Desktop" folders
  • Only enable syncing on projects that you need
  • The Kahua host must be running for files to sync; make sure you log in at least once per day
  • Folders cannot be created locally; users must create folders using the Kahua host
  • When deleting via via the local directory; users must confirm the deletion in the Kahua host
  • Files deleted via the Kahua host will be removed from the user's local directory
  • Folders that have been shared to you are not synced

There are two components to enabling file sync:  setting up your machine, which only needs to be performed one time; and enabling a project.  Once a project has been enabled, a sub-folder for your company will be created at the location you have selected and the project hierarchy will be built out below based on enabled projects.  

To set up File Sync on your machine:

  1. Open the Status dialog and select the Settings tab for File Sync
  2. In the Synchronization section, check the box to Enable syncing
  3. Click "Set Local Path"
  4. Browse to a directory on your machine where you would like to store the files, for instance, "Documents" or "Desktop".  The folder must be a local directory on your machine to permit offline access.  
  5. Save

To enable a project for syncing:

  1. Navigate to the project you would like to sync
  2. Open the Status dialog and select the Settings tab for File Sync
  3. In the Project section, click "Enable"
    NOTE:  The first time you enable a project, it can take several minutes for all files to be synced to your machine


  • If you find that files are not syncing, try disabling the File Sync functionality by unchecking the "Enabled?" box in the Synchronization section on the Settings tab, saving and then re-enabling the sync
  • It can take several minutes for all files to be synced and show in the Kahua host and/or Windows Explorer.  The amount of time it takes is affected by the number of files and folders being synced, the connection speed and the hardware specifications of your machine