PHPackages                             geerlingguy/drupal-vm-docker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps &amp; Deployment](/categories/devops)
4. /
5. geerlingguy/drupal-vm-docker

AbandonedArchivedComposer-plugin[DevOps &amp; Deployment](/categories/devops)

geerlingguy/drupal-vm-docker
============================

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

1.1.0(6y ago)204544[3 issues](https://github.com/geerlingguy/drupal-vm-docker/issues)MITPHP

Since Apr 8Pushed 3y ago1 watchersCompare

[ Source](https://github.com/geerlingguy/drupal-vm-docker)[ Packagist](https://packagist.org/packages/geerlingguy/drupal-vm-docker)[ RSS](/packages/geerlingguy-drupal-vm-docker/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependencies (1)Versions (9)Used By (0)

DEPRECATED - Drupal VM Docker Composer Plugin
=============================================

[](#deprecated---drupal-vm-docker-composer-plugin)

> **This project has been deprecated. It is no longer maintained.**

[![Packagist](https://camo.githubusercontent.com/8db6832ff9fcce284a7e12f97187e140b4839e1b4f5d9a27c9bdb492ac345da8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f676565726c696e676775792f64727570616c2d766d2d646f636b65722e737667)](https://packagist.org/packages/geerlingguy/drupal-vm-docker) [![Docker Automated build](https://camo.githubusercontent.com/5395745659de433098fc8312add57df15f873447999453818145fd31940562e6/68747470733a2f2f696d672e736869656c64732e696f2f646f636b65722f6175746f6d617465642f676565726c696e676775792f64727570616c2d766d2e7376673f6d61784167653d32353932303030)](https://hub.docker.com/r/geerlingguy/drupal-vm/) [![](https://camo.githubusercontent.com/9a466b60857d9b9b360bf933108a0fa7b7787e25e1e34cd1f4a6a0e4ed9848fa/68747470733a2f2f696d616765732e6d6963726f6261646765722e636f6d2f6261646765732f696d6167652f676565726c696e676775792f64727570616c2d766d2e737667)](https://microbadger.com/images/geerlingguy/drupal-vm "Get your own image badge on microbadger.com") [![irc://irc.freenode.net/drupal-vm](https://camo.githubusercontent.com/f4572858e943f0f8d6e031a2c9e5be364aca175f5697921f0547dc35e8abc31a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6972632e667265656e6f64652e6e65742d25323364727570616c2d2d766d2d627269676874677265656e2e737667)](https://riot.im/app/#/room/#drupal-vm:matrix.org)

**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](https://store.docker.com/search?type=edition&offering=community) 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
-----------------------------

[](#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
--------------------------------

[](#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
-------

[](#license)

This project is licensed under the MIT open source license.

About the Author
----------------

[](#about-the-author)

[Jeff Geerling](https://www.jeffgeerling.com/) created the Drupal VM Docker Composer Plugin in 2018 for a more efficient Drupal site and core/contrib development workflow.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~87 days

Recently: every ~153 days

Total

8

Last Release

2394d ago

Major Versions

0.0.7 → 1.0.02018-04-08

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/481677?v=4)[Jeff Geerling](/maintainers/geerlingguy)[@geerlingguy](https://github.com/geerlingguy)

---

Top Contributors

[![geerlingguy](https://avatars.githubusercontent.com/u/481677?v=4)](https://github.com/geerlingguy "geerlingguy (15 commits)")

---

Tags

composerdockerdrupaldrupal-vmlocallocal-environmentpluginvm

### Embed Badge

![Health badge](/badges/geerlingguy-drupal-vm-docker/health.svg)

```
[![Health](https://phpackages.com/badges/geerlingguy-drupal-vm-docker/health.svg)](https://phpackages.com/packages/geerlingguy-drupal-vm-docker)
```

###  Alternatives

[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k16.7M1.0k](/packages/phpro-grumphp)[symfony/runtime

Enables decoupling PHP applications from global state

74798.8M997](/packages/symfony-runtime)[johnpbloch/wordpress-core-installer

A custom installer to handle deploying WordPress with composer

21911.3M50](/packages/johnpbloch-wordpress-core-installer)[roots/wordpress-core-installer

A Composer custom installer to handle installing WordPress as a dependency

4216.6M50](/packages/roots-wordpress-core-installer)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5344.1M552](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2124.7M200](/packages/drupal-core-project-message)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
