Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

Change the settings files of another root

exp:ini --root=<dir> works on the settings tree of another root (a copy of the installation); the INI cache there is not cleared, and the scope must exist there.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/build-two-ways/examples/migrate/settings-on-another-root.md

On this page

Change the settings files of another root

Prepare the menu list in a copy of the installation before changing the live one.

Life cycle: Migrate, example 10 of 34. Worked out on the Fit & Healthy site of Exponential 6.0.15+.

Contents

  1. In the Layouts editor
  2. With settings
  3. Which to choose
  4. Check

In the Layouts editor

Not in the Layouts editor.

With settings

  1. ./console exp:ini add menu.ini/SiteInfo/MainMenuID[] 192 siteaccess:site --root=/path/to/copy --dry-run.
  2. The scope must exist in that root: in a fresh checkout of the repository, which has no settings/siteaccess/site/ of the installation, the test answered Refused: Unknown siteaccess 'site' (not in settings/siteaccess/ nor in AvailableSiteAccessList). Extension scopes work in a checkout of the extension.

Which to choose

Useful for preparing releases.

Check

  • The copy's file has the change; the running site is unchanged.

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x