oo

Configuring Virtual Instances

Liferay PaaS 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, Clarity Vision Solutions has both an external, public facing website for their business and an internal intranet for its employees that it calls Glance. These are built using virtual instances.

Virtual Instances in Liferay SaaS

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

Virtual Instances in Liferay PaaS 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: glance.clarityvisionsolutions.com
    • Virtual Host: glance.clarityvisionsolutions.com
    • Mail Domain: clarityvisionsolutions.com
    • 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.

    127.0.0.1 glance.clarityvisionsolutions.com

    note

    If using a docker container, --add-host glance.clarityvisionsolutions.com:127.0.0.1 entry must be included in your run command.

  4. Once the virtual instance is successfully added, navigate to http://glance.clarityvisionsolutions.com:8080/.

    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