What is the up-to-date basic workflow regarding database credentials when you launch a local version of a site that is already operating remotely?

What are the considerations and how is each best addressed? Are there advanced considerations that might require one to vary the basic approach?

Thoughtful confirmations of the community's understanding welcomed. (As appropriate) I'll happily help kick off documentation. It appears not to be documented clearly elsewhere, though if someone else has seen clear documentation on each point of the workflow and related decisions, please include links in your remarks.


As promised above, I've started working on improving drupal docs. I've opened an issue https://www.drupal.org/project/user_guide/issues/3013725

  • As promised above, I've started working on improving drupal docs. I've opened an issue drupal.org/project/user_guide/issues/3013725
    – lacuna
    Commented Nov 14, 2018 at 17:57
  • I replied to your suggestion in the Drupal issue queue, @lacuna - seems like a good set of improvements to make! Kevin's outline matches with my understanding.
    – Kay V
    Commented Nov 16, 2018 at 21:23

1 Answer 1


Its common to either include a local settings file from settings.php or create a site folder for local development (local.mysite.com) that has a settings file that will be used. In either case, both are gitignored so its only for you. This also avoids the annoying issue when Drupal locks the site folders from being written, causing git errors when pulling or switching branches.

  • Thanks @Kevin - your notes got me pointed in a productive direction (including starting an effort to improve drupal docs - see comment above). I imagine it'll be productive to confirm more details. I'll break out related concerns in this question thread.
    – lacuna
    Commented Nov 14, 2018 at 18:00

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.