Skip to content

Setting Up The Dev Environment

Installing System Requirements

MacOS Requirements

Windows Requirements

Linux Requirements

Initializing The DDEV Project

  1. Visit the project template repository and click the "Use this template" button in the top right, choosing to "Create a new repository".
  2. Once the repository is created, clone it to your local machine.
  3. On your local machine, you will need to configure the DDEV project name. This only has to be done once as this will get saved to the DDEV config. We usually use the domain name without the .com extension (ie. example.com would be example).: 
    ddev config --project-name=example
  4. Start the container: 
    ddev launch
  1. Clone the project repository to your local machine.
  2. Read the project's README.MD file for any extra setup necessary.
  3. Start the container: 
    ddev launch
Here's what happens when you start a fresh container

When starting a project container for the first time, the DDEV hooks defined in .ddev/config.yaml will automatically perform several tasks:

  • Authorize the container to access IWW's private composer repositories hosted on Repman.io
  • Install Composer dependencies in ./
  • Install Node NPM dependencies in ./
  • Install Node NPM dependencies in /vendor/iww/prism/bin/
  • Create the database and populate it with test data
  • Build the frontend assets with ddev build

Explore the Admin Panel

Now is a good time to pause and explore the administration panel for yourself if you haven't already.

ddev admin;

Once you have a grasp of the administration panel, you can continue this documentation to learn how to use the container services, manage frontend assets, and more. The default username and password for the administration panel is: 

Username: servers@integratedwebworks.com
Password: letmein

We recommend changing this password and documenting it somewhere safe.