ONLYOFFICE Docs
v8.2
ONLYOFFICE Docs changelog
Version 8.2.1
Release date: 11/12/2024
Version 8.2.0
Release date: 10/17/2024
Version 8.1.1
Release date: 07/15/2024
Version 8.1.0
Release date: 06/19/2024
Version 8.0.1
Release date: 02/26/2024
Version 8.0.0
Release date: 01/30/2024
Version 7.5.1
Release date: 11/08/2023
Version 7.5.0
Release date: 10/17/2023
Version 7.4.1
Release date: 07/31/2023
Version 7.4.0
Release date: 06/13/2023
Version 7.3.3
Release date: 03/15/2023
Version 7.3.2
Release date: 02/14/2023
Version 7.3.0
Release date: 01/31/2023
Version 7.2.2
Release date: 12/20/2022
Version 7.2.1
Release date: 10/21/2022
Version 7.2.0
Release date: 09/22/2022
Version 7.1.1
Release date: 06/02/2022
Version 7.1.0
Release date: 05/12/2022
Version 7.0.1
Release date: 02/22/2022
Version 7.0.0
Release date: 01/18/2022
Version 6.4.2
Release date: 10/14/2021
Version 6.4.1
Release date: 09/28/2021
Version 6.4.0
Release date: 08/26/2021
Version 6.3.2
Release date: 08/10/2021
Version 6.3.1
Release date: 06/08/2021
Version 6.3.0
Release date: 05/20/2021
Version 6.2.2
Release date: 04/19/2021
Version 6.2.1
Release date: 03/31/2021
Version 6.2.0
Release date: 03/01/2021
Version 6.1.1
Release date: 01/28/2021
Version 6.1.0
Release date: 12/02/2020
Version 6.0.2
Release date: 11/12/2020
Version 6.0.1
Release date: 10/28/2020
Version 6.0.0
Release date: 10/14/2020
Version 5.6.5
Release date: 09/21/2020
Version 5.6.4
Release date: 09/08/2020
Version 5.6.3
Release date: 08/17/2020
Version 5.6.2
Release date: 08/07/2020
Version 5.6.1
Release date: 08/05/2020
Version 5.6.0
Release date: 07/29/2020
Version 5.5.3
Release date: 05/22/2020
Version 5.5.1
Release date: 04/09/2020
Version 5.5.0
Release date: 03/05/2020
Version 5.4.2
Release date: 11/27/2019
Version 5.4.1
Release date: 10/02/2019
Version 5.4.0
Release date: 09/03/2019
Version 5.3.4
Release date: 07/16/2019
Version 5.3.2
Release date: 06/24/2019
Version 5.3.1
Release date: 06/06/2019
Version 5.3.0
Release date: 05/28/2019
Version 5.2.8
Release date: 02/05/2019
Version 5.2.7
Release date: 01/16/2019
Version 5.2.6
Release date: 12/25/2018
Version 5.2.4
Release date: 12/12/2018
Version 5.2.3
Release date: 10/31/2018
Version 5.2.2
Release date: 10/05/2018
Version 5.2.0
Release date: 09/28/2018
Version 5.1.5
Release date: 07/18/2018
Version 5.1.4
Release date: 05/24/2018
Version 5.1.3
Release date: 04/27/2018
Version 5.1.2
Release date: 04/11/2018
Version 5.1.1
Release date: 04/05/2018
Version 5.1.0
Release date: 03/28/2018
Version 5.0.7
Release date: 01/16/2018
Version 5.0.6
Release date: 12/11/2017
Version 5.0.5
Release date: 11/28/2017
Version 5.0.4
Release date: 11/14/2017
Version 5.0.3
Release date: 11/02/2017
Version 5.0.2
SaaS only
Release date: 10/13/2017
Version 5.0.1
SaaS only
Release date: 10/05/2017
Version 5.0.0
SaaS only
Release date: 09/23/2017
Version 4.4.4
Release date: 09/13/2017
Version 4.4.3
Release date: 08/14/2017
Version 4.4.2
Release date: 07/24/2017
Version 4.4.1
Release date: 07/05/2017
Version 4.3.6
Release date: 06/14/2017
Version 4.3.5
Release date: 06/05/2017
Version 4.3.4
Release date: 05/16/2017
Version 4.3.3
Release date: 04/28/2017
Version 4.3.2
Release date: 04/17/2017
Version 4.3.1
Release date: 04/06/2017
Version 4.3.0
Release date: 04/03/2017
Version 4.2.11
Release date: 03/13/2017
Version 4.2.10
Release date: 02/20/2017
Version 4.2.9
Release date: 02/14/2017
Version 4.2.8
Release date: 02/06/2017
Version 4.2.7
Release date: 02/01/2017
Version 4.2.5
Release date: 01/16/2017
Version 4.2.4
Release date: 01/09/2017
Version 4.2.3
Release date: 12/23/2016
Version 4.2.2
Release date: 12/21/2016
Version 4.2.1
Release date: 12/06/2016
Version 4.2.0
Release date: 12/01/2016
Version 4.1.8
Release date: 11/03/2016
Version 4.1.7
Release date: 11/01/2016
Version 4.1.6
Release date: 10/26/2016
Version 4.1.5
Release date: 10/13/2016
Version 4.1.4
Release date: 10/07/2016
Version 4.1.3
Release date: 09/28/2016
Version 4.1.2
Release date: 09/22/2016
Version 4.0.3
Release date: 08/04/2016
Version 4.0.2
Release date: 08/03/2016
ONLYOFFICE Groupsv12.7.0
ONLYOFFICE Groups changelog
If you want to connect ONLYOFFICE Docs to the ONLYOFFICE Groups portal installed on your local or remote server, you will need to alter configuration files both on the computer with ONLYOFFICE Groups and ONLYOFFICE Docs installed. So please first make sure you have administrator access to both machines.
ONLYOFFICE Docs and ONLYOFFICE Groups must be installed on two different machines.
What and how must be changed
Connecting ONLYOFFICE Docs to ONLYOFFICE Groups requires changing some connection strings either in the ONLYOFFICE Groups portal interface at the Settings page or in the configuration files. There are the following addresses used by ONLYOFFICE Docs which must be introduced into ONLYOFFICE Groups configuration so that they became connected:
- http://documentserver/ - for the user access
- http://documentserver/ - for the ONLYOFFICE Groups access
- http://communityserver/ - for the ONLYOFFICE Docs access
In case you plan to use both ONLYOFFICE Docs and ONLYOFFICE Groups on your local network and the users will be accessing them using local network only, it is okay to change these addresses the following way:
- http://documentserver-localaddress/ - for the user access
- http://documentserver-localaddress/ - for the ONLYOFFICE Groups access
- http://communityserver-localaddress/ - for the ONLYOFFICE Docs access
But if you plan to access the servers from outside (using the Internet connection), the below rules must be followed:
- The first address is used by ONLYOFFICE Docs API service and, in case the editors are accessed from the Internet, the public DNS address must be used with it, as it will communicate not only with ONLYOFFICE Groups machine but also with the user computer.
- The second and the third addresses are used to solely route the communication between the two servers (Docs and Groups), and do not require any Internet connection, so it is safe to use the local network addresses here in case both computers are in the same local network even if ONLYOFFICE Docs and/or ONLYOFFICE Groups is planned to be accessed from other computers via the Internet.
- If ONLYOFFICE Groups and ONLYOFFICE Docs are located in different networks and the editors need to be accessed via the Internet, you can specify the first address only. The value of the second will be that of the first field and the third will be taken from the browser address bar.
The steps below will explain where to find these addresses in different ONLYOFFICE Groups versions.
Connecting ONLYOFFICE Docs to ONLYOFFICE Groups
Normally, to connect ONLYOFFICE Docs to ONLYOFFICE Groups version 8.1 and later you only need to set up connection parameters in portal settings. To do that:
- Go to the portal Settings and select the Integration -> Document Service section.
- Fill in all the fields with the appropriate ONLYOFFICE Docs/ONLYOFFICE Groups addresses.
- If your ONLYOFFICE Docs/ONLYOFFICE Groups installations are not switched to https, please, make sure that you specify
http
in the addresses.
- Save the settings by clicking the Save button.
Starting from ONLYOFFICE Docs
v7.2, JWT is enabled by default and the secret key is generated automatically. You need to specify the JWT parameters in the ONLYOFFICE Groups configuration file as well. For more details, see the
Configuring JWT section of this article.
ONLYOFFICE Docs and ONLYOFFICE Groups version compatibility table
Please note, that not all ONLYOFFICE Groups and ONLYOFFICE Docs versions can be connected to each other. In case you have ONLYOFFICE Groups version incompatible with the current ONLYOFFICE Docs version or vice versa, please consider upgrading to the latest versions or at least to the nearest compatible ones.
The table below shows which server versions can be connected to each other without any problems:
|
|
ONLYOFFICE Docs version |
|
|
7.4 |
7.3 |
7.2 |
7.1 |
7.0 |
6.4 |
6.3 |
6.2 |
6.1 |
6.0 |
5.5 |
5.4 |
5.3 |
5.2 |
5.1 |
5.0 |
ONLYOFFICE Community Server version |
12.5 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.1 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
12.0 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.6 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11.5 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.0.1 – 11.0 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.6 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.5 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.0 – 9.1 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
View the older ONLYOFFICE Groups and ONLYOFFICE Docs versions compatibility table
Hide the older ONLYOFFICE Groups and ONLYOFFICE Docs versions compatibility table
|
|
ONLYOFFICE Docs version |
|
|
4.4 |
4.2 – 4.3 |
3.8 – 4.1 |
3.5 |
3.0 |
2.5 |
ONLYOFFICE Community Server version |
9.1 |
|
|
|
|
|
|
9.0 |
|
|
|
|
|
|
8.9.2 |
|
|
|
|
|
|
8.8 – 8.9.1 |
|
|
|
|
|
|
8.7 |
|
|
|
|
|
|
8.1 – 8.6 |
|
|
|
|
|
|
7.7 |
|
|
|
|
|
|
No stable work of the incompatible versions can be guaranteed and we strongly recommend that you update your installations to the latest available versions for correct work.
Editing configuration files for ONLYOFFICE Groups
In case this does not work or you are using ONLYOFFICE Community Server earlier than version 8.1 and you are sure that the ONLYOFFICE Groups version is compatible with the ONLYOFFICE Docs version you are trying to connect (please consult the table above to see if that is so), you will need to perform the actions below, editing the configuration files.
First of all you need to alter the web.appsettings.config file which can be found in the c:\Program Files\Ascensio System SIA\onlyoffice\WebStudio\
folder of the ONLYOFFICE Groups computer. Open it with a text editor and add the following lines (or change these lines accordingly, in case they are already present):
<add key="files.docservice.viewed-docs" value=".pptx|.ppsx|.pptt|.ppt|.pps|.odp|.gslides|.xlsx|.xlst|.xls|.ods|.gsheet|.csv|.docx|.doct|.doc|.odt|.gdoc|.txt|.rtf|.mht|.html|.htm|.fb2|.epub|.pdf|.djvu|.xps"/>
<add key="files.docservice.edited-docs" value=".pptx|.ppsx|.pptt|.ppt|.pps|.odp|.xlsx|.xlst|.xls|.ods|.csv|.docx|.doct|.doc|.odt|.txt|.rtf|.mht|.html|.htm|.fb2|.epub"/>
<add key="files.docservice.convert-docs" value=".ppt|.pps|.odp|.xls|.ods|.doc|.odt|.rtf|.mht|.html|.htm"/>
<add key="files.docservice.coauthor-docs" value=".pptx|.pptt|.xlsx|.xlst|.docx|.doct"/>
<add key="files.docservice.url.public" value="http://documentserver/" />
<add key="files.docservice.url.internal" value="http://documentserver/" />
<add key="files.docservice.url.portal" value="http://communityserver/" />
Where documentserver
and communityserver
are the addresses of the computers with ONLYOFFICE Docs and ONLYOFFICE Groups installed.
These lines must be inserted between the <add key="files.uploader.chunk-size" value="5242880" />
and <add key="resources.from-db" value="true" />
lines.
If you are trying to connect
ONLYOFFICE Docs to
ONLYOFFICE Community Server version
earlier than
8.5, you will need to add two additional lines to your
web.appsettings.config file:
<add key="files.docservice.new" value=".xlsx|.xlst|.xls|.ods|.gsheet|.csv|.docx|.doct|.doc|.odt|.gdoc|.txt|.rtf|.mht|.html|.htm|.fb2|.epub|.pdf|.djvu|.xps"/>
<add key="files.docservice.url.apinew" value="http://documentserver/coauthoring/CommandService.ashx"/>
You will also need to run the SQL script for proper work (for ONLYOFFICE Docs 3.0 and higher):
INSERT INTO `webstudio_settings` (`TenantID`, `ID`, `UserID`, `Data`) VALUES (-1, 'a3acbfc4-155b-4ea8-8367-bbc586319553', '00000000-0000-0000-0000-000000000000', '{"NewScheme":true,"RequestedScheme":true}');
For ONLYOFFICE Docs 2.5 the following SQL script must be run (without running the above script!):
DELETE FROM `webstudio_settings` WHERE `ID`='a3acbfc4-155b-4ea8-8367-bbc586319553';
Configuring JWT
To protect documents from unauthorized access, ONLYOFFICE editors use the JSON Web Token (JWT). The token is added in the configuration when the Document Editor is initialized and during the exchange of commands between inner ONLYOFFICE Docs services. The secret key is used to sign the JSON web token and validate the token upon the request to ONLYOFFICE Docs. The JWT header defines the HTTP header that will be used to send the JSON web token.
Starting from ONLYOFFICE Docs v7.2, JWT is enabled by default and the secret key is generated automatically. You need to find your secret key and JWT header in the ONLYOFFICE Docs configuration file, then specify the same values in the ONLYOFFICE Groups configuration file.
Step 1: Find your secret key and JWT header in the ONLYOFFICE Docs configuration file
Open the local.json
file which can be found at the following path:
- For Linux -
/etc/onlyoffice/documentserver/local.json
- For Windows -
%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
Find the secret key value in the following strings:
services.CoAuthoring.secret.inbox.string
services.CoAuthoring.secret.outbox.string
services.CoAuthoring.secret.session.string
Find the JWT header value in the following strings:
services.CoAuthoring.token.inbox.header
services.CoAuthoring.token.outbox.header
Step 2: Specify your secret key and JWT header in the ONLYOFFICE Groups configuration file
Open the WebStuido/web.appsettings.config
file with any available text editor.
Edit the following keys by specifying the secret key and JWT header values:
<add key="files.docservice.secret" value="your_key" />
<add key="files.docservice.secret.header" value="your_header" />
Restart the site.
Editing configuration files for ONLYOFFICE Docs
Next the web.config file need to be altered. It can be found in the c:\Program Files\Ascensio System SIA\ONLYOFFICE Online Editors\DocService\
folder of the ONLYOFFICE Docs computer. Open it with a text editor and add the following lines (or change these lines accordingly, in case they are already present):
<add key="editor.settings.coauthoring.url" value="http://documentserver:8000" />
<add key="editor.settings.spellchecker.url" value="http://documentserver:8080" />
Where documentserver
is the address of the computer with ONLYOFFICE Docs installed.
Connecting ONLYOFFICE Docs 2.5 to ONLYOFFICE Community Server 7.7 and earlier
ONLYOFFICE Docs
v2.5
ONLYOFFICE Groupsv7.7
To connect ONLYOFFICE Docs 2.5 to the computer with ONLYOFFICE Community Server 7.7 and earlier installed, you need to only edit the web.appsettings.config file from the WebStudio
folder of the ONLYOFFICE Community Server computer. Open it with a text editor and add the following lines (or change these lines accordingly, in case they are already present):
<add key="files.docservice.url.converter" value="http://documentserver/ConvertService.ashx"/>
<add key="files.docservice.url.api" value="http://documentserver/OfficeWeb/apps/api/documents/api.js"/>
<add key="files.docservice.url.storage" value="http://documentserver/FileUploader.ashx"/>
These are the addresses for the conversion service, editing service and storage service accordingly used with ONLYOFFICE Docs 2.5.
You do not need to change anything else, including altering the web.config file for ONLYOFFICE Docs.