.. /*  
    * 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-install:

.. figure:: ../images/manual/savapage-logo-no-text-100px.png
   :width: 75px

Server Installation
===================

.. admonition:: |ADMONITION_TABLE_OF_CONTENTS|

   - :numref:`{number}. {name} <ch-install-sysreq>`
   - :numref:`{number}. {name} <ch-install-create-user-account>`
   - :numref:`{number}. {name} <ch-install-config-cups-samba>`
   - :numref:`{number}. {name} <ch-install-optional-system-settings>`
   - :numref:`{number}. {name} <ch-install-check-firewall>`
   - :numref:`{number}. {name} <ch-install-download>`
   - :numref:`{number}. {name} <ch-install-save-encryption-keys>`
   - :numref:`{number}. {name} <ch-install-configure>`
   - :numref:`{number}. {name} <ch-install-share-client-files>`
   - :numref:`{number}. {name} <ch-install-testing>`
   - :numref:`{number}. {name} <ch-install-what-is-next>`


This chapter covers the *initial* installation and configuration of
SavaPage in your network environment.

-  If you are installing a new version over an existing installation
   please consult |RST_LINK_APPENDIX_UPGRADING|.

-  If this installation is part of a migration from an old server please
   consult |RST_LINK_APPENDIX_MIGRATING| before going on.

Initial installation takes only a few minutes on a prepared server. This
guide will walk you through installation and configuration step-by-step.
The process is summarized below: 

1. System requirements check. 
2. Downloading and installing |PRODUCT_NAME|. 
3. Completing the configuration. 
4. Testing the software.

.. tip::

   If you would like to know the technical details behind the
   SavaPage installer, take a look at the :ref:`Installation Process <ch-install-on-linux-process>`.


.. _ch-install-sysreq:

Step 1 - System Requirements
----------------------------

Before proceeding with the installation you should take a few moments to
verify system requirements. Is the operating system version supported
and are patches up-to-date? Take a few minutes to verify the system is
current and supported (see :ref:`System Requirements <ch-intro-sys-req>`).

The SavaPage installation program needs the commands ``which``,
``strings``, ``gunzip`` and ``perl``. So, make sure the ``binutils``,
``debianutils`` (for Debian based systems), ``perl`` and ``gzip``
packages are installed.