File system based workflow

Last updated on
21 March 2017

This documentation is incomplete. Add more information.

Please note that Drupal by default keeps configuration management information in the database. For the file system based workflow to work, you will need to modify your settings.php and services.yml files.

You should do this before installing Drupal, as it is complex to revert back to database-based configuration management setup once you switch to file-based. If you need to enable configuration in files after the site installation, you must export your configuration first, and store a copy in the active configuration folder before enabling file based configuration.

Note: you must have different active and staging directories (as per the config below) - the config import step is still required for a file-based workflow. See this issue - file system based workflow does not correctly install/uninstall modules without the config import step.

  1. Open your settings.php file, find the section "Active configuration settings".
  2. Uncomment the line starting with $settings['bootstrap_config_storage'] to enable file based configuration storage.
  3. Add the following code to settings.php (modified from
    $config_directories[CONFIG_ACTIVE_DIRECTORY] = 'PATH_OUTSIDE_WEB_ROOT/config/active/';
    $config_directories[CONFIG_STAGING_DIRECTORY] = 'PATH_OUTSIDE_WEB_ROOT/config/staging/';

    Save the file.

  4. Open the services.yml file in sites/default and add the following code (code taken from
        class: Drupal\Core\Config\CachedStorage
        arguments: ['', '@cache.config']
        class: Drupal\Core\Config\FileStorage
        factory: Drupal\Core\Config\FileStorageFactory::getActive
  5. Copy the configuration (.yml) files from the origin website's active folder to the origin website's staging folder.
  6. Use a tool (rsync, git, ftp, scp) to copy the content of the origin's staging folder to the destination's staging folder
  7. In the destination website visit admin/config/development/configuration
  8. Click import all