There are two quick ways to get Drutopia up and running: PHP on your local computer or a full, production-like environment provided by a virtual machine.

In both cases we’ll end with the Drutopia distribution codebase, built by Composer, in a directory called my-drutopia-site (please change this to whatever you would like in the instructions below!).



  1. PHP (5.5.9+, 7.1+ preferred; test in a terminal with php --version).

  2. Composer.

Note: If you have composer installed globally you can use composer instead of ./composer.phar in the first command.


Run these commands in a terminal

  1. Install the code base using Composer:

    • ./composer.phar create-project drutopia/drutopia_template:dev-master --no-interaction my-drutopia-site

  2. Change into the project directory:

    • cd my-drutopia-site

  3. Run a script to get the latest tested versions of all Drupal projects for the Drutopia release you’re installing.

    • ./vendor/bin/composer-pin-apply web/profiles/contrib/drutopia/bin/drutopia-tested-global-pinnings.sh

    • For more information, see web/profiles/contrib/drutopia/bin/README.md

  4. Change into the web root and start PHP’s built-in server:

    • cd web && php -S localhost:8008

  5. Open localhost:8008 and follow the installation instructions; leaving everything at defaults will be fine.

See the README that was downloaded in that step for more.

Virtual machine


  1. Install VirtualBox (check your app store or package manager)

  2. Install Vagrant (check your app store or package manager)


  1. git clone git@gitlab.com:drutopia/drutopia_vm.git my-drutopia-site

  2. cd drutopia_vm

  3. vagrant up (this runs a site install via drush but unfortunately no Drutopia features are enabled).

  4. Log in at my-drutopia-site.test/user with the credentials username: admin, password: admin

  5. Enable Drutopia modules at my-drutopia-site.test/admin/modules

You can access the virtual machine (for use of Drush etc) with vagrant ssh.