Configuring headless clients
This article describes how to configure and connect clients in a headless mode without a graphical user interface (GUI) to PowerFolder Server. This is useful, if PowerFolder Server is used to synchronize files between servers.
Configuring the client to run in a headless mode for Windows
Configuring PowerFolder to run in a headless mode as a system service on Windows is straightforward:
- Create a user account for PowerFolder in the web interface of the server, if not already done.
- Download, install and start PowerFolder using an administrative account. The administrative account is required to install PowerFolder as a system service.
- Enter the user account name and password to activate the client.
- Click on Preferences > Plugins.
- Select System Service and click on Enable.
- Select System Service and click on Configure.
- Click on Install and then on OK.
- Close PowerFolder.
Closing the PowerFolder user interface after configuring it as a system service should automatically take care of starting PowerFolder as a system service.
Configuring the client to run in a headless mode for Linux
Configuring PowerFolder to run in a headless mode as background process on Linux requires an existing PowerFolder.config file, which includes the relevant information to connect to the server:
- Create a user account for PowerFolder in the web interface of the server, if not already done.
- Follow Step 1 & 2 from our Installing on Linux Guide. Tough we are not installing a server, the first two steps are the same for installing a client.
- Create a sub-directory called
/powerfolder
in the home directory of the dedicated user for PowerFolder. - Download and extract the latest PowerFolder Linux .tar.gz package file into the directory created in the step before.
Create a
PowerFolder.config
file in the same directory with the contents below:PowerFolder.configconfig.url=http://powerfolder.example.com:8080 nick= server.connect.username=username server.connect.password=password
Replace the value for
config.url
with the URL of the PowerFolder Server web interface.
Replace the value forserver.connect.username
andserver.connect.password
with the username and password created in the first step.
Replace the value fornick
with a name under which the device should appear in the web interface.Change file permissions for the
PowerFolder-Client.sh
file:chmod +x PowerFolder-Client.sh
Execute the
PowerFolder.sh
file:./PowerFolder-Client.sh start
PowerFolder should now start and connect to the server specified in the config.url
parameter. Click on Devices in the web interface to see if the client connected successfully to the server. If that is the case, it should be listed there.
If the client doesn't show up in the web interface of the server, add the line verbose=true
to the PowerFolder.config
file. PowerFolder will then generate logs in a sub-directory called /logs
, where errors are listed.