Google Cloud Storage
Self-Hosted Only
Available for Liferay DXP 7.3 SP3+ and 7.4+
Liferay DXP provides integration with Google’s Cloud Storage (GCS) service. With GCS integration, you can seamlessly store and access your Liferay instance files in the cloud.
Before enabling this connection, you must first prepare your GCS account. When ready, configure the Liferay instance to use GCS via the Control Panel, and set the dl.store.impl
portal property to use GCS as the default store.
If a database transaction rollback occurs in a Document Library, the transaction’s file system changes are not reversed. Inconsistencies between Document Library files and those in the file system store can occur and may require manual synchronization. This is a limitation of all DXP stores besides DBStore.
GCS Prerequisites
Enabling Liferay’s GCS integration requires an active GCS account and project. This project must have a storage bucket and a service account to enable server-to-server, app-level authentication. You must also create a JSON security key for the service account. See official Google Cloud Storage documentation for more information.
The service account’s security key must use the JSON key type.
Configuring the GCS Store in Liferay
Follow these steps to configure the GCS Store:
-
Open the Global Menu (
), click on the Control Panel tab, and go to Configuration → System Settings.
-
Click on File Storage.
-
Click on GCS Store Configuration.
-
(Required) Enter the following information.
-
Service Account Key: the private JSON key used to securely access the GCS project’s service account.
-
Bucket Name: the name of the GCS bucket used to store files.
-
-
(Optional) Configure Liferay call attempts to GCS.
-
(Optional) Enter an AES-256 encryption Key for an extra layer of security.
-
Click Save when finished.
Once you’ve configured the GCS Store, you can set GCS as your default file storage system.
Setting GCS as Default Store
Follow these steps to use GCS as the default Store for the Liferay instance:
-
Add the following property to the instance’s
portal-ext.properties
file:If a
portal-ext.properties
file doesn’t exist, create a new one with the above value and add it to the instance’s LIFERAY_HOME or[USER_HOME]
folder.This overrides the default value for
dl.store.impl
in theportal.properties
file. -
Restart the Liferay server.