Submit Feedback
Legacy Knowledge Base
Published Jul. 2, 2025

Social Office Setup Guide

Written By

Liferay Support

How To articles are not official guidelines or officially supporteddocumentation. They are community-contributed content and may not alwaysreflect the latest updates to Liferay DXP. We welcome your feedback toimprove How to articles!

While we make every effort to ensure this Knowledge Base is accurate, itmay not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with anyfeedback or concerns.

Legacy Article

You are viewing an article from our legacy "FastTrack"publication program, made available for informational purposes. Articlesin this program were published without a requirement for independentediting or verification and are provided "as is" withoutguarantee.

Before using any information from this article, independently verify itssuitability for your situation and project.

This article describes how to get a Social Office instance up and running for the Liferay Portal.

Resolution

Activation key

In order to use Social Office EE, users will require an activation key. Users can check if they have one by going to liferay.com > Account > License > App. If there is a Social Office entry here, then they have an activation key for Social Office. However if there is no entry, users can either:

  1. Request an activation key
  2. Use a trial license (see below)

Download

To download the latest Social Office from Liferay Marketplace, users must first purchase it. To do so:

  1. Go to Liferay Marketplace > Social Office EE > 30-day trial > download
  2. Register with trial activation key.
    • Note that the hostname is all that is required for registration.
  3. Go to liferay.com > User Profile > Apps > Personal Use > Social Office EE
  4. The App button downloads the latest versions, however, users can reach the previous versions by clicking the Find Past Versions link. If users cannot find the app in the list, it means users do not have an activation yet. See the Activation Key section.
Note: For Social Office EE 3.0.1+, when users click the 'App' button to download the latest version, they will need to go through the online activation key registration process. In this process users will be asked to choose one of the already registered instances to download, or to register a new one. This way, the Social Office lpkg will contain the activation key file.

Deploy & Register

Once users have downloaded the Social Office .lpkg file, they should copy it to the deploy folder.

If the activation key file is not included in the .lpkg

  • Go to Admin > Control Panel > License Manager
  • Paste the Order Id
    • Navigate to Marketplace > Apps > Social Office EE
  • Then Next, Next, Finish
  • Restart the portal

If the activation key file is included in the .lpkg (3.0.1+)

  • It will be hot deployed, which registers the plugin automatically.
  • Activation keys also come in XML files which can be hot deployed.

The result of the registration may be checked in the log and on the portal's License Manager page.

Setup

To have access to Social Office, users need to grant the "Social Office User" role to the user in question. In Liferay Portal 6.2, there will be an alert when users click the "+" sign on the left.

Upgrading Social Office

To upgrade Social Office (SO), simply deploy the newer version to the hot deploy folder. If SO has been registered earlier, there is no need to register the newer version.

There is an upgrade issue with some portal versions which leaves junk files in the webapps folder. These can cause issues such as an unstable SO and Liferay. To prevent this from happening, set hot.undeploy.on.redeploy=true in the portal-ext.properties before deploying the newer version. Remember to shut down the application server, then restart.

Did this article resolve your issue ?
Legacy Knowledge Base
Did this article resolve your issue ?