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.

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

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:

Setting	Description
f.<local_folder_identifier>.archive	Obsolete
f.<local_folder_identifier>.dir	Defines the local path to the folder.
f.<local_folder_identifier>.dlscript	Defines a script to be executed when a new file has been synchronized from a remote device.
f.<local_folder_identifier>.id	The unique ID of the folder. This will get generated by the server! Don't edit this on your own!
f.<local_folder_identifier>.name	Defines the name of the folder, which is used for display in the client.
f.<local_folder_identifier>.preview	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>.versions	Defines 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.

Setting	Description
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.detection	Defines if the client shows a message if a conflict gets detected which offers the possibility to restore the version.
create.folder.allow.network	Defines if it is allowed to create a folder on a network share.
default.archive.versions	Defines how many local file versions get stored.
foldersbase	Path where the client actively scans for new folders.
port	Defines the port where the client listens for other client in network.
server.connect.username	Defines the login username, when connecting to a cloud.
server.connect.password	Defines the login password, when connecting to a cloud.
server.idp.external_names	Configurable 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