📝OnlyOffice Integration

For Docker deployment, you need to upgrade the image to the official Docker image version v6 or above. For other deployment methods, handle the system dependencies yourself.

Starting from version 1.3.1, MrDoc Professional Edition supports integration with OnlyOffice to enable viewing, uploading, creating, and modifying Office files directly within the site.

To use the OnlyOffice-based online Office editing and preview features, you must first deploy an OnlyOffice service.

## 1. Deploying OnlyOffice

>i The content of this section is referenced from the OnlyOffice deployment documentation.
>
> You can deploy OnlyOffice according to the [Deployment Guide](https://api.onlyoffice.com/zh/editors/getdocs) provided by OnlyOffice. We recommend using the [Docker image](https://github.com/ONLYOFFICE/Docker-DocumentServer) provided by OnlyOffice for deployment.

### Deploying OnlyOffice with Docker

>i OnlyOffice Official Docker Image Documentation: https://hub.docker.com/r/onlyoffice/documentserver

```shell
docker run -d --restart=always --name oo \
-p 8123:80 \
-v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
-v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
-v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
onlyoffice/documentserver:latest
```

The above command will run an OnlyOffice container named `oo` on port `8123` and mount the OnlyOffice data in the `/app/onlyoffice/DocumentServer/` directory.

### Viewing the JWT Token

Enter the following command in the terminal to obtain the default JWT token value of OnlyOffice. Please copy it for configuration use.

```
docker exec oo /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
```

### Additional Configuration: Reverse Proxy - WebSocket Support

If you use Nginx or other tools such as Baota Nginx to set up a reverse proxy for the deployed OnlyOffice, you need to add additional Nginx configurations to support WebSocket:

```
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
```

Taking Baota as an example, you can add the following configuration in the reverse proxy settings:

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/15/2023-08-15_183621_8759720.0426048922232104.png)

### Additional Configuration: Reverse Proxy - HTTPS Additional Configuration

If your deployed OnlyOffice uses HTTPS, you also need to add the following configuration:

```
proxy_set_header X-Forwarded-Proto https;
```

Refer to the Baota settings image above for configuration details (image omitted).

## 2. Configuring MrDoc

After the OnlyOffice service is deployed, you need to fill in the relevant OnlyOffice configuration information in MrDoc. Once configured, you can directly use OnlyOffice-based Office documents in MrDoc.

Go to the "Admin Panel" -> "Site Settings" page, select "Collection, Document, Asset Settings", and under the "OnlyOffice Configuration" section, enter the OnlyOffice service address and the [JWT Token](#h3-viewing-the-jwt-token). Finally, enable the OnlyOffice feature switch and save the configuration.

>d Please note that the OnlyOffice service address URL must end with a trailing slash `/`, for example: `https://onlyoffice.mrdoc.pro/`.

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/09/2023-08-09_210339_7052330.6912929240951615.png)

### 2.1. HTTPS Additional Configuration

If your MrDoc uses HTTPS, you must add the following configuration to the Nginx reverse proxy settings of MrDoc:

```
proxy_set_header X-Forwarded-Proto $scheme;
```

Otherwise, you might encounter the error message: "==This document cannot be saved. Please check the connection settings or contact the administrator...==".

## 3. Usage

When the OnlyOffice feature switch is enabled, the "New" menu bar on the homepage, collection, and document pages will include an "OnlyOffice" option. Click it to enter the OnlyOffice document creation page.

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/09/2023-08-09_210740_2176380.9085379089580656.png)

Here, you can directly choose to create a new Word, Excel, PowerPoint, Form file, etc., or upload an Office file from your local machine:

![](http://file.mrdoc.pro/mrdoc-oss/img/2023/08/09/2023-08-09_210843_0630720.04988627209768215.png)

After selection, the OnlyOffice editing interface will be rendered. Once editing is complete, follow the standard document publishing process.

![](http://file.mrdoc.pro/mrdoc-oss/img/2025/01/03/8271beb2d80f438cb9457b205a9b96cd4850.png)