Serve Volto on a subpath

A Volto site can be served on a subpath, for example, https://mysite.com/subpath. This is useful when you want to leave the root path available for another website that's not the same version or theme of the Volto site served on the subpath. By using a subpath for your Volto site, you could serve another CMS, a Plone Classic UI site, or even a static site from the root of the hostname. Routing is typically handled upstream of Volto in a router server, such as Traefik.

When this is enabled, both content and static assets are served on the subpath. To use a subpath, run Volto with the RAZZLE_SUBPATH_PREFIX environment variable set to the subpath.

RAZZLE_SUBPATH_PREFIX=/subpath make start

If you build bundles to run in production mode, you must set the environment variable at both build and run times as shown.

RAZZLE_SUBPATH_PREFIX=/subpath make build && pnpm prod:start

In the above example, you would access the site at http://localhost:3000/subpath in your browser.