A "site" on DDEV-Live is a project which has information attached to it and which can be referenced in commands.

<site> is what you want to call your project on DDEV-Live. It must consist of lower case alphanumeric characters or ''-'', start with an alphabetic character, and end with an alphanumeric character.


To create your project on DDEV-Live and import code from GitHub with the default settings, run:

$ ddev-live create site drupal <org>/<site> --github-repo <github-org>/<repo-name> [flags]

You can add flags for specific configuration options. Use a command as follows to see all possible flags and their descriptions:

$ ddev-live create site wordpress -h


The previous command is tightly coupled with the GitHub API and GitHub Apps, and therefore it does not support any other Git hosts. As we are gradually introducing integrations with more third-party tools and platforms, for GitLab we have added more universal set of flags that are agnostic of the Git hosting provider and newly support not only branches but also tags and any other valid Git revisions:

$ ddev-live create site drupal <org>/<site> --git-repo <git-repository-url> --git-rev <branch/tag/commit> [flags]

Working with your site on DDEV-Live

The DDEV-Live GitHub app watches the specified branch of your repo. When you push updates to the repo, DDEV-Live will redeploy the site. This will take a few minutes to complete.

  • View a list of all the sites within a specified organization with ddev-live list sites --org <org>.
  • View the state of a specific site with ddev-live describe site <org>/<site>.
  • Use ddev-live config to modify the GitHub repo or branch to pull from.
  • Use ddev-live delete to delete a resource. For example, ddev-live delete site <org>/<site>.

Last update: 2020-08-03