Liferay

Introduction

ONLYOFFICE allows you to edit the files stored in your Liferay account and collaborate on them using both online and desktop ONLYOFFICE editors. Thereby, you can use not only online collaboration tools but also the features available in your desktop application:

• access to system fonts, the clipboard, and system printers.

To take full advantage of all these editing options, you will need to install and configure several components:

1. It's supposed that you already have a Liferay server instance installed and configured. If not, you can refer to the Liferay official installation instructions.
2. Install ONLYOFFICE Docs. Please note that the Liferay server and ONLYOFFICE Docs must be accessible to each other over the network.
3. Enable our official integration app in the Liferay administrator account.
4. Connect your Liferay server to ONLYOFFICE Desktop Editors.

Step 1. Install ONLYOFFICE Docs

The easiest way to install ONLYOFFICE Docs is to use Docker. Execute the following command:

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

To find more detailed instructions on how to install ONLYOFFICE Docs using Docker, you can refer to this article.

To make sure that ONLYOFFICE Docs is installed successfully, enter the IP address and, optionally, port (if it has been changed during the installation) in your browser address bar, e.g., http://192.168.3.202:81 - the ONLYOFFICE Docs welcome page should open.

Step 2. Install and configure the ONLYOFFICE connector for Liferay

You can install the ONLYOFFICE connector using the App Manager or from the official Liferay App Store. To install it using the App Manager, navigate to Control Panel -> Apps -> App Manager. Click the Options button, then click the Upload button. In the opened window, choose the ONLYOFFICE application file. To install the connector from the App Store, navigate to Control Panel -> Apps -> Store. Sign in with your Liferay account. Search for the ONLYOFFICE Connector for Liferay. Purchase the application (it is free). When the installation is completed, the application is ready for use.

When the connector is installed, you need to configure it. On the ONLYOFFICE application settings page, specify the address of the machine where the ONLYOFFICE Docs is installed in the ONLYOFFICE Docs address field. If you’ve changed the port during the installation, do not forget to specify it, e.g. http://192.168.3.202:81. Click the Save button to apply the settings.

To find out more details on configuring the integration app, you can refer to the corresponding article for Liferay.

Step 3. Connect to Liferay server

Launch ONLYOFFICE Desktop Editors. To connect Desktop Editors to your Liferay server, perform the following actions:

1. Click the Plus button next to the Clouds section on the left side panel.
2. Click the Liferay cloud service button, or use the Connect now link at the bottom.
   
3. If you pressed the Liferay service button, the Connect to cloud office window opens with the Liferay selected. If you used the Connect now link, choose the Liferay cloud storage from the drop-down list.
4. in the Cloud office URL field, enter your Liferay server domain name or IP address. When ready, click the Connect now button.
   

5. The Liferay sign in page will open in a new tab of the Desktop Editors interface.

   • Specify your Email Address and the Password you use to access your Liferay account,
   • Click the Sign in button.
   

Your Liferay account main page will open. Now you can edit your existing files and create new ones, share your documents, and collaborate on them with Liferay users using ONLYOFFICE editors.

Step 4. Manage your connected accounts

Click the logo in the upper left corner of the Desktop Editors interface to return to the main program window. All the connected cloud accounts appear on the left-side panel below the Clouds section. Click the three dots that appear as you hover the mouse over the connected cloud to access the cloud contex menu options:

• Open - to switch to the corresponding cloud storage tab if you are already logged in to this account, or to open the Connect to cloud office window if you are not currently logged in (in such a case, you will need to enter your credentials),
• Logout - to exit from your account,
• Remove from list - to disconnect the selected account and remove it from the list.

To connect several accounts or clouds, click the Plus button next to the Clouds section on the left side panel.