Client Configuration Files

The client stores important settings in two configuration files called PowerFolder.config and PowerFolder-Folder.config. On this page we will explain some of the settings in the client configuration files.

Editing the client configuration file

The client configuration file can be edited with a simple text editor of your choice.

(Warnung) Please note: Make sure you stopped the client before editing the configuration file, otherwise your changes might get overwritten!

Location of the client configuration file

Depending on the operating system the client is running on, the client configuration file can be found in one of the directories below:

  • Windows 7 / 8.1 / 2008 R2 / 2012 / 2012 R2 / 2016: C:\Users\<username>\AppData\Roaming\PowerFolder
  • Linux/Mac: /home/<username>/.PowerFolder

(Warnung) Please note: On Windows make sure your file browser is enabled to show hidden/system files!


On Windows open your file explorer and enter %APPDATA%\PowerFolder in the address bar to navigate to the config directory.


Basic settings

Folder settings

To change the local directory on a system not running a graphical user interface (e.g. Windows Server as a system service or Linux server) simply edit the corresponding lines in the PowerFolder-Folder.config file.


Example of a folder configuration
f.d7fa8ccabbdcc962f39125057be70807.archive=FULL_BACKUP
f.d7fa8ccabbdcc962f39125057be70807.dir=C:\\Users\\User1\\PowerFolders\\My Folder
f.d7fa8ccabbdcc962f39125057be70807.dlscript=
f.d7fa8ccabbdcc962f39125057be70807.id=[34XC89fd9sDJMJJ43]
f.d7fa8ccabbdcc962f39125057be70807.name=My Folder
f.d7fa8ccabbdcc962f39125057be70807.preview=false
f.d7fa8ccabbdcc962f39125057be70807.syncprofile=true,true,true,true,10,false,12,0,m,Auto sync (10 Minutes),false
f.d7fa8ccabbdcc962f39125057be70807.versions=5

Some explanation:

SettingDescription
f.<local_folder_identifier>.archive(Fehler) Obsolete
f.<local_folder_identifier>.dirDefines the local path to the folder.
f.<local_folder_identifier>.dlscriptDefines a script to be executed when a new file has been synchronized from a remote device.
f.<local_folder_identifier>.idThe unique ID of the folder. (warning)This will get generated by the server! Don't edit this on your own!(warning)
f.<local_folder_identifier>.nameDefines the name of the folder, which is used for display in the client.
f.<local_folder_identifier>.preview(Fehler) Obsolete
f.<local_folder_identifier>.syncprofile

Defines the configured transfer mode. It has the following syntax:

  • (boolean) auto-download from friends,
  • (boolean) auto-download from others (deprecated),
  • (boolean) deletion sync with friends,
  • (boolean) deletion sync with others (deprecated),
  • (integer) time units between change detect,
  • (boolean) sync daily (false=periodical/continuous),
  • (integer) daily hour,
  • (integer) days (0=every day, 1 to 7=days of week, 8=weekdays, 9=weekends),
  • (string) timeunit for periodical change detect (h=hours, m=minutes, s=seconds),
  • (boolean) if use instant sync or not
f.<local_folder_identifier>.versionsDefines how many versions of a file should be stored locally.

Client settings

These settings can be found in the PowerFolder.config file. Every general setting of the client gets stored in this file.

SettingDescription
config.url

Defines from which server the default configuration should be pulled, the first time the client starts. This should be the address of the cloud web interface. Example:

config.url=https://my.powerfolder.com

conflict.detectionDefines if the client shows a message if a conflict gets detected which offers the possibility to restore the version.
create.folder.allow.networkDefines if it is allowed to create a folder on a network share.
default.archive.versionsDefines how many local file versions get stored.
foldersbasePath where the client actively scans for new folders.
portDefines the port where the client listens for other client in network.
server.connect.usernameDefines the login username, when connecting to a cloud.
server.connect.passwordDefines the login password, when connecting to a cloud.
server.idp.external_namesConfigurable text for external users in login panel for Shibboleth logins. Example:
server.idp.external_names=LRZ,RRZE,KIT
verbose

Activates the logging for the client.

Values: TRUE and FALSE

Full list of settings

More options of the client configuration file can be found in our client source code on GITHub.

Overview