Documentation/PalmOrder Server

PalmOrder Server

Installation

How to choose and install PalmOrder Server on Windows, macOS or with the portable JVM package.

Choose the distribution that corresponds to the operating system of the server. All variants run the same PalmOrder Server and use the same control panel.

Windows

The Windows distribution is designed to run normally on a work computer or server.

Minimum requirements for PalmOrder Server 7: Windows 10 or later, or Windows Server 2019 or later.

  1. Extract the distribution to a permanent directory, for example C:\PalmOrderServer.
  2. Open config\application.yml and change the admin password before the first working run.
  3. Double-click PalmOrder Server.exe.
  4. The PalmOrder icon will appear in the system tray. Through its menu, you can open the control panel, configuration, data and logs.

If needed, the server can be started without a tray via run-console.bat or installed as a Windows service.

macOS (Apple Silicon)

The public distribution for macOS is for Apple Silicon (arm64) computers.

  1. Move PalmOrder Server.app to the Applications folder.
  2. Launch the application.
  3. Open the PalmOrder menu in the macOS menu bar.

The app does not open a separate window or appear in the Dock. Data, configuration and logs are stored in ~/Library/Application Support/PalmOrder Server.

Important. The current macOS distribution is not signed or notarized. If macOS blocks the launch, enable it in the Privacy & Security section of System Preferences.

Portable JVM

This option is suitable for Linux, macOS, or Windows, when the server is managed by an administrator or its own startup service.

  1. Install Java Runtime or JDK version 25.
  2. Verify that the command below shows the installed version:
java --version
  1. Extract the archive to a permanent directory.
  2. Edit config/application.yml.
  3. Start the server:
# macOS або Linux
./run.sh

# Windows
run.bat

To change the port for just one run, pass the argument:

./run.sh --server.port=8899

After installation

Regardless of the distribution variant, continue with the page First run.