.. _install:

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

This chapter walks through installing the TOA server on a Linux host.
The server is a single Spring Boot fat jar shipped together with a
sample configuration file; installation is a matter of unpacking the
release zip, adjusting ``config/toa-server.yml`` for the target
environment, and running the jar as a service.

The chapter assumes a customer-managed Linux host and a reverse proxy
in front of the server that terminates TLS and forwards both the
Outlook add-in task pane and the ``/api/`` calls to this server on the
same origin (see :ref:`client-hosting`). Windows Server deployments
are technically supported via the same jar but are not covered in
detail here; they will be added in a later revision of the
documentation.

Publishing the Outlook add-in to end users is covered separately in
:ref:`client`.

.. toctree::

   prerequisites.rst
   server.rst
   verify.rst
   upgrade.rst