How to install ONLYOFFICE on Synology

With ONLYOFFICE Docs on your Synology NAS, you can edit documents, spreadsheets, presentations, and PDFs directly in your private cloud, ensuring security and efficiency for your workflows. This guide provides step-by-step instructions on how to install ONLYOFFICE Docs on Synology.

About Synology

Synology NAS (Network-Attached Storage) is a network-attached storage solution that enables secure, accessible data storage and sharing for authorized users. Operating on Synology DiskStation Manager (DSM), a Linux-based OS, Synology NAS optimizes data organization, team collaboration, and secure file storage in one integrated system.

Adding ONLYOFFICE Docs to Synology makes document editing and management more efficient by enabling real-time co-editing, direct access, and secure storage of files — all managed from within your NAS. This setup streamlines teamwork, keeps files secure on your server, and provides a powerful editing suite tailored to your storage environment.

How to install ONLYOFFICE Docs on Synology

Now, let’s look at the steps required to install ONLYOFFICE Docs Community on Synology using the simplest way — via Docker. You also have the option of choosing ONLYOFFICE Docs Enterprise, designed for larger teams and delivered with enhanced support.

Setting up your Synology NAS device

Step 1. Connect to the network

Connect your device to the network and to the local network.

Start the device, download, and install the operating system via the convenient and understandable wizard — follow the wizard using default options. Add a user and a password.

Optionally, add disks in a RAID configuration to enhance data redundancy.

Step 2. Install container manager

Click the Package Center shortcut on the desktop. In the All Packages category find Container Manager and install it by clicking the corresponding button.

Step 3. Add Community package source

Enable additional packages from the Synology Community repository to access the usual Linux utilities.

Go to Package Center > Settings. Under the Package Sources tab, click Add.

Specify Syno Community in the Name field and https://packages.synocommunity.com/ in the Location field. Click OK.

Step 4. Install SynoCli file tools

In the Package Center, select the Community tab on the left. Install SynoCli File Tools.

Installing ONLYOFFICE Docs via Container Manager (Docker)

This method uses Synology’s graphical interface for ease of setup.

Step 1. Download ONLYOFFICE Docs Image

Go to the Registry tab in Container Manager, type ONLYOFFICE in the search bar, and look for the image called onlyoffice/documentserver.

Click on it, select a tag to choose a specific version, and click Download. The changelog for all available versions  is always available in the official ONLYOFFICE GitHub repository.

There are also a few commercial versions available:

• DE – Developer Edition
• EE – Enterprise Edition

However, if you don’t need a commercial license, simply download the free Community Edition.

Step 2. Create a new container

Once the download is complete, you can create a new container from the downloaded image.

Right-click the downloaded image and select Run. A setup window will appear where we’ll configure the container:

• General Settings: Name the container.
• Port Settings: Map port 4433 on your Synology to the container’s default HTTPS port (443) and port 8080 to HTTP port 80.
• Volume Settings: Mount directories like logs and data inside the container to shared folders on your NAS.
• Environment Variables: Adjust the variables based on your needs. For the Community Edition, remove the ProductEdition field.

Click Apply to finish the setup.

Step 3. Verify the installation

Now we can check that everything is working correctly. Open a browser and navigate to http://<Synology_IP>:8080.

If the ONLYOFFICE Docs welcome page appears, the installation is successful.

Watch our detailed step-by-step guide on installation:

Installing ONLYOFFICE Docs via enabling SSH

Alternatively, those who like to work with terminal commands can install ONLYOFFICE Docs over SSH. Follow these steps:

Step 1. Enable SSH access

Go to Control Panel > Terminal & SNMP. Enable SSH by checking the Enable SSH service box and clicking Apply.

Step 2. Connect via SSH

On Linux, you can use an SSH client like OpenSSH. Enter ssh username@ip_address to your terminal and click Yes to continue connecting to the server.

Step 3. Run ONLYOFFICE Docs

Follow these instructions to install the Docker version of ONLYOFFICE Docs.

Ensure you specify a different port, such as 8000, if port 80 is already being used by another application.

Step 4. Access the ONLYOFFICE Docs interface

Once installed, open ONLYOFFICE Docs by entering http://<IP_address>:<Port>/ in a browser. This will load the ONLYOFFICE Docs Welcome page.

Exploring ONLYOFFICE Docs features on Synology

To explore the solution functionality, enable our test example which will allow you to upload your local files for testing. To do that, execute the following command:

sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example

Add the example to the autostart:

sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

Now you can open the ONLYOFFICE Docs example page in your browser.

From the ONLYOFFICE Docs example page, you can:

• Upload a file stored on your PC using the Upload file option.
• Create a new blank text document, spreadsheet, presentation, or PDF form using the Create new -> Document, Spreadsheet, Presentation, or PDF form options. If you want to create a file with sample content, first check the With sample content box.
• Test co-editing capabilities by selecting another test user from the Username list and then clicking on the same document in the Your documents list to open it in a new browser tab.

Integrating ONLYOFFICE Docs into your platform

Now, you can integrate ONLYOFFICE Docs into your platforms, enhancing your document management and editing capabilities. ONLYOFFICE Docs features ready-made connectors for popular systems such as Nextcloud, ownCloud, Alfresco, SharePoint, Moodle, Confluence, and WordPress. Сheck the full integration list:

FIND INTEGRATION