Configuring Virtual Instances

Configuring Virtual Instances

LXC-SM or Self-hosted

You may have a business use case where you need another Liferay environment with its own set of sites, users, and organizations. Rather than spinning up a brand new server, you can create a virtual instance.

For example, Delectable Bonsai has both an external, public facing website for their business and an internal intranet for its employees that it calls Breakfast. These are built using virtual instances.

Virtual Instances in LXC

Contact your Liferay Cloud support person for setting up virtual instances.

Virtual Instances in LXC-SM and Self-hosted

  1. Navigate to Global Menu (Global Menu) → Control PanelVirtual Instances.

  2. Click Add (Add icon) and enter the following information.

    • Web ID:
    • Virtual Host:
    • Mail Domain:
    • Max Users: 0 (note, this means unlimited users)
    • Active: toggle on
    • Virtual Instance Initializer: select Blank Site.

    Enter the virtual instance information.

    Click Save. Your new virtual instance ready.

  3. Since this is not a real externally hosted site, add the domain to your /etc/hosts file of your local system.


    If using a docker container, --add-host entry must be included in your run command.

  4. Once the virtual instance is successfully added, navigate to

    The new virtual instance is ready to use.

Create an Administrator for the New Instance

Virtual instances are separate Liferay instances. The new instance you just created has no user accounts in it. Create one for Kyle Klein so he can administer this instance as well.

If you need a reminder for how to do that, you can go back and follow the instructions to register him and make him an administrator of this instance.

The next step is to configure instance settings.

Relevant Concepts