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 Groups
v12.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 might 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 /var/www/onlyoffice/WebStudio/
folder of the ONLYOFFICE Groups computer. Open it with a text editor (e.g. nano):
sudo nano /var/www/onlyoffice/WebStudio/web.appsettings.config
And add the following lines (or change these lines accordingly, in case they are already present):
<add key="files.docservice.url.public" value="http://documentserver-publicaddress/" />
<add key="files.docservice.url.internal" value="http://documentserver-localaddress/" />
<add key="files.docservice.url.portal" value="http://communityserver/" />
Where documentserver-publicaddress
is the address of the computer with ONLYOFFICE Docs available for public networks, documentserver-localaddress
is the address of the computer with ONLYOFFICE Docs available for local network and communityserver
is the address of the computer with ONLYOFFICE Groups installed.
For
ONLYOFFICE Community Server version earlier than
9.6 you will need to edit the following lines:
<add key="files.docservice.url.converter" value="http://documentserver/ConvertService.ashx" />
<add key="files.docservice.url.api" value="http://documentserver/web-apps/apps/api/documents/api.js" />
<add key="files.docservice.url.apinew" value="http://documentserver/web-apps/apps/api/documents/api.js" />
<add key="files.docservice.url.preloader" value="http://documentserver/web-apps/apps/api/documents/cache-scripts.html" />
<add key="files.docservice.url.storage" value="http://documentserver/FileUploader.ashx" />
<add key="files.docservice.url.portal" value="http://communityserver/" />
<add key="files.docservice.url.command" value="http://documentserver/coauthoring/CommandService.ashx" />
Where documentserver
and communityserver
are the addresses of the computers with ONLYOFFICE Docs and ONLYOFFICE Groups installed.
These lines must be inserted after the <add key="files.docservice.secret.header" value="" />
line.
After that restart the monoserve service:
sudo service monoserve restart
You will also need to run the SQL script for proper work:
sudo mysql -u root -p
Enter the password, after that you should see the SQL welcome promtp:
mysql>
Which means that you successfully entered SQL database. Enter the command (not omitting the semicolon):
use onlyoffice;
Now you can run the command:
DELETE FROM `webstudio_settings` WHERE `ID`='a3acbfc4-155b-4ea8-8367-bbc586319553';
In case there are problems with documents, you can try to change the <add key="web.client.cache.resetkey" value="3" /> line of the web.appsettings.config file entering any other numerical value instead of 3.
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.