/ddev

DDEV-Local: a local PHP development environment system

Primary LanguageGoApache License 2.0Apache-2.0

ddev

CircleCI project is maintained Gitpod Ready-to-Code

ddev logo

ddev is an open source tool that makes it simple to get local PHP development environments up and running in minutes. It's powerful and flexible as a result of its per-project environment configurations, which can be extended, version controlled, and shared. In short, ddev aims to allow development teams to use Docker in their workflow without the complexities of bespoke configuration.

Getting Started

  1. Check System Requirements: We support recent versions of macOS, Windows 10, and Linux distributions that will run Docker (ddev requires Docker and docker-compose). (more info here).
  2. Install ddev: Options include macOS homebrew (recommended), an install script, or manual installation.
  3. Read the Basics and Choose a CMS Quick Start Guide:

Having trouble? See our support options below. You might have trouble if another local development tool is already using port 80 or 443.

Partial Feature List

  • Quickly create multiple local web development environments based on code repositories.
  • Import database for a project you're working on.
  • Import upload files to match the project (e.g. Drupal's sites/default/files or WordPress's wp-content/uploads).
  • Pantheon integration - grab a Pantheon archive and work locally with the database and files.
  • Run commands within the docker environment using ddev exec.
  • View logs from the web and db containers.
  • Use ddev ssh to explore the linux environment inside the container.
  • List running projects with ddev list.
  • Snapshot databases with ddev snapshot.
  • Temporarily share your development website with other using ddev share.
  • Trusted HTTPS support

Just running ddev will show you all the commands.

Support

We love to hear from our users and help them be successful with ddev. Support options include:

  • ddev Documentation and faq
  • ddev StackOverflow for support and frequently asked questions. We respond quite quickly here and the results provide quite a library of user-curated solutions.
  • ddev issue queue for bugs and feature requests
  • The gitter drud/ddev channel (it's easy to log in many diffferent ways)
  • The #ddev channels in Drupal Slack, TYPO3 Slack for interactive, immediate community support.
  • ddev-contrib repo provides a number of vetted user-contributed recipes for extending and using ddev. Your contributions are welcome.
  • awesome-ddev repo has loads of external resources, blog posts, recipes, screencasts, and the like. Your contributions are welcome.
  • Twitter with tag #ddev will get to us, but it's not as good for interactive support, but we'll answer anywhere.

Additional Information

  • Contributing See the "How can I contribute" question in the FAQ.
  • Roadmap: See the ddev roadmap. We love your input! Make requests in the ddev issue queue.