I would like to run the Pay Server without the Windows runner or installer. Can I do this?

Sure! The core of the server is a runnable Jar with an embedded server which you can run on any platform that supports Java, including Mac OS X or popular Linux distributions.

First off, if you're using Windows, you can run the Pay Server in the Windows bundle directly with the included run script, just double click server/run-server.bat. This is the script which gets executed on the background service when you install and run it.

If you would like to run the Jar manually, or on another system, the only requirement is to have JRE 8 installed on your system.

First download the server Jar from our release artifactory. Then you need to create a config.yaml file and place it in the same directory as the downloaded Jar. For details about the configuration file see configuring the Pay Server page.

When your configuration is ready you can run the server using a command such as:

java -Dlog4j.configuration=log4j-production.xml -Dfile.encoding=UTF-8 -jar mpos.payserver.server-1.1.0-all.jar io.payworks.payserver.server.Server

Make sure to reference the correct Jar file with the latest release version.

The log4j-production.xml is the logging configuration we use for running the server in production mode which is embedded inside the Jar. This configuration will log everything both to the console output and to file system with log rotation. If you wish you can supply your own log4j configuration file with an option such as -Dlog4j.configuration=file:"./your/properties/path/log4j.xml".

Can we help you?

If you cannot find your answer, contact us and we'll get in touch with you soon.