.. /*  
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _ch-user-client-deployment:

|USER_CLIAPP| Deployment
------------------------

.. contents:: |RST_TABLE_OF_CONTENTS|
   :depth: 2
   :local:


.. _ch-user-client-deployment-intro:

Introduction
~~~~~~~~~~~~

Since the software is written in Java it can be deployed on any platform
where Java SE 11 or higher is installed, like Microsoft Windows, macOS
and GNU/Linux. The |USER_CLIAPP| software is installed on the server in
the ``/opt/savapage/client/app`` directory.

.. caution::

   Running the |USER_CLIAPP| directly from a network share can cause
   performance problems, resulting in an unresponsive application.
   Therefore is it recommended to run the client from a local copy.

.. note::

   The User Client is resilient in the event that the connection with
   the server is (temporarily) lost. The connection will be restored
   automatically after a short break. If the connection is lost for a
   longer period of time, the user is notified with a pop-up message
   with the choice to try again or to close the application.

.. _ch-user-client-deployment-windows:

Deployment on Windows
~~~~~~~~~~~~~~~~~~~~~

The ``savapage-client.bat`` batch file that starts the application is
available in the ``/opt/savapage/client/app`` directory on the
server.

.. note::

   Make sure to enable Balloon Notification in Windows Group Policy to
   allow users to see notification messages.

.. _ch-user-client-deployment-macos:

Deployment on macOS
~~~~~~~~~~~~~~~~~~~

The ``savapage-client`` shell script that starts the application is
available in the ``/opt/savapage/client/app`` directory on the
server.

.. _ch-user-client-deployment-linux:

Deployment on GNU/Linux
~~~~~~~~~~~~~~~~~~~~~~~~

The ``savapage-client`` shell script that starts the application is
available in the ``/opt/savapage/client/app`` directory on the
server.