geerlingguy/drupal-vm-docker

A quick and easy Docker-based Drupal project development environment.

Fund package maintenance!
geerlingguy
Patreon

Installs: 451

Dependents: 0

Suggesters: 0

Security: 0

Stars: 17

Watchers: 3

Forks: 3

Open Issues: 3

Type:composer-plugin

1.1.0 2019-12-11 19:17 UTC

This package is auto-updated.

Last update: 2022-01-11 23:47:15 UTC


README

Packagist Docker Automated build irc://irc.freenode.net/drupal-vm

The quickest way to add a local development environment to your Drupal project!

Get started:

composer require --dev geerlingguy/drupal-vm-docker

Run this command inside the directory of a Drupal project that is built using Composer, and it will create a Docker Compose file which will run a local instance of Drupal VM.

Make sure you have Docker CE installed and running, then run docker-compose up -d. After a minute or two, you should be able to access your Drupal site at http://localhost/.

To install Drupal, the default Drupal VM database name, username, and password are all drupal.

Shutting down the environment

When you're finished developing, run the command:

docker-compose stop

And once you're ready to develop again, run:

docker-compose start

If you want to completely clear out the local environment (e.g. to start over or if you're finished with a project), run:

docker-compose down

Updating the Docker Compose file

The Docker Compose file should be updated automatically any time you update to a newer version of this plugin. However, you can also manually force the file to be updated by running:

composer drupal-vm-docker-update

You should then tell Docker to restart anything that needs to be restarted with docker-compose up -d.

License

This project is licensed under the MIT open source license.

About the Author

Jeff Geerling created the Drupal VM Docker Composer Plugin in 2018 for a more efficient Drupal site and core/contrib development workflow.