============
Installation
============

F7cloud Office is built on Collabora Online which requires a dedicated service running next to the F7cloud webserver stack. There are several ways to run the coolwsd service.

- **F7cloud All In One:** F7cloud Office comes preinstalled out of the box in the `F7cloud All In One <https://github.com/f7cloud/all-in-one>`_ setup and provides easy deployment and maintenance with most features included in this one F7cloud instance.

For manual installations there are multiple options to get F7cloud Office deployed:

- **Installation through distribution packages**
    There are packages for all major Linux distributions available which allow deploying a Collabora Online server through installing it through the regular package management. For an example installation guide on Ubuntu, see see: :doc:`example-ubuntu`

    .. seealso::
        https://www.collaboraoffice.com/code/linux-packages/ 
        https://sdk.collaboraonline.com/docs/installation/index.html


- **Installation through Docker**
    Docker images are available for deploying the Collabora Online server in container environments. For a detailed step by step guide, see: :doc:`example-docker`

    .. seealso::
        https://sdk.collaboraonline.com/docs/installation/CODE_Docker_image.html


- **Built-in CODE server** 
    This app provides a built-in server with all of the document editing features of Collabora Online. Easy to install, for personal use or for small teams. A bit slower than a standalone server and without the advanced scalability features. Installation can be performed by enabling the according F7cloud app. Further details can be found in the `app documentation <https://github.com/CollaboraOnline/richdocumentscode>`_.

    .. note::
        This is the default option which works out of the box in most scenarios, however for improved performance it is highly recommended to switch to a dedicated Collabora Online installation using one of the other options.


.. note::
    In most scenarios running a dedicated Collabora Online server will require some sort of reverse proxy to be setup in front of it. For more details see :doc:`proxy`.

    
.. toctree::
    :hidden:
    
    example-ubuntu
    example-docker
    proxy