.. _onlyoffice-install:

OnlyOffice
----------

.. figure:: /_static/using/files/onlyoffice.png
   :alt: OnlyOffice

   OnlyOffice

Run your private office with Group-Office and `OnlyOffice <https://www.onlyoffice.com>`_.
Designed to make collaboration easy. A complete productivity suite to run your entire business with.
Edit Text Documents, Spreadsheets and Presentations online in your browser.

You'll need a working OnlyOffice installation first following their guides at https://www.onlyoffice.com.

When you have that setup and running. You need to install the module in Group-Office at
:ref:`System Settings -> Modules <modules>`.

.. figure:: /_static/using/files/onlyoffice-module-install.png
   :alt: OnlyOffice Module installation
   :width: 100%

   OnlyOffice Module installation

Check the box and add the appropriate permissions in the dialog that pops up.

Now reload Group-Office and go to System Settings -> OnlyOffice:

.. figure:: /_static/using/files/onlyoffice-systemsettings.png
   :alt: OnlyOffice System settings
   :width: 100%

   OnlyOffice System settings

Configure at least the URL to your OnlyOffice server.

Now you can open a document in the files module with OnlyOffice by right clicking on a file and
choose :ref:`'Open with...' <files-open-with>`.

.. note:: If you get a 404 error when editing because /onlyoffice is not found then you probably are missing the alias in your
   webserver configuration. The Group-Office Debian and Docker packages automatically create this but with the tarball
   package you have to do this manually.
   :ref:`Example configuration can be found here. <webserver-aliases>`