Virtual stacks

Terminology

  • Base stack: the primary SilverStripe Platform environment.
  • Virtual stack: a secondary environment sharing the same resources as the base stack.

A virtual stack, or “vstack”, can be used to host multiple sites on one SilverStripe Platform stack. Please consider the size and performance of your stack before adding a vstack as this will share the same server resources as the base stack.

Adding a virtual stack

Virtual stacks can be created by a stack manager, after an initial deployment has been made to all environments on the base stack, by clicking on the Virtual stacks tab on the stack overview page.

Virtual Stack Tab

If there are existing virtual stacks they will be shown on this page, or you can click “Create virtual stack” to make a new one. Fill out the details and click “Add stack” to get started.

Virtual Stack Creation Page

Once the virtual stack is created, the base environment will require a full deployment before you can deploy to the virtual stack.

.platform.yml and full deployments

Virtual stacks use the same configuration as the base stack .platform.yml file. If a .platform.yml file is included in a virtual stack’s code base, it will not take effect.

A virtual stack cannot be full deployed to. To apply configuration changes such as whitelists, new domains or variables you will need to make this change on your virtual stack in the Platform Dashboard and then full deploy to the base stack.