Submit Feedback
Legacy Knowledge Base
Published Jul. 2, 2025

Common Errors in Remote Staging in Liferay DXP

Written By

Justin Choi

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

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

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

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

This article documents the activation and setup errors in Remote Staging, and lists steps to resolve the issue or avoid it altogether. If users want to know about activating staging in general, please see Enable Remote Live Staging.

Resolution

Error: Users are unable to publish content to Remote Staging.

Summary: Users are attempting to publish content to a remote live server from their staged environment but encounter errors.

Common Causes

  1. Servers are missing the correct tunnel.servlet.hosts.allowed= in the remote server’s portal-ext.properties.
  2. SSL has been improperly configured.

Recommended Solution

As already explained on the user interface, and in other documentation, put the tunnel.servlet.hosts.allowed= setting in remote server's portal-ext.properties with the IP address of the staged server.

Alternately, users can use the Control Panel on the Remote Server. To use the Control Panel, execute the following steps:

  1. Navigate to Control Panel > Configuration > System Settings
    remotestaging_01.PNG
  2. Search for the Tunnel Auth Verifiers setting and click it.

    (For users working on DXP 7.1, the setting has been renamed Tunnel Authentication)
    remotestaging_02.PNG

  3. Click on /api/liferay/do.
  4. In the list of Hosts allowed, enter the URL of the Staged Server.
    remotestaging_03.PNG
  5. Click Update
Caution: As a general principle, Control Panel settings will override portal-ext.properties settings. Ensure that any changes made in the Control Panel are the desired changes.

If users desire to publish content across a secure connection, enable the application server's SSL connections and consult the appropriate application server documentation.

Prevention Tips

  1. If the user has enabled SSL, ensure that Java security files have been generated correctly and that they are in the right file folder for each application server. Ensure that the application server's secure ports have been activated (e.g. 8443, in most cases).

  2. Ensure that the target's IP, port, and site ID (e.g. 10444) are correct in the staged server.

Additional Information

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