Install Craft CMS

At this point you should have a local development environment running with a database and know how to run console commands. Now it’s time to install Craft CMS.

The first step is to decide where you want your Craft project to live. If you already have a place you like to store dev projects, create a new tutorial/ folder in there. Otherwise, you might consider creating a dev/tutorial/ folder within your system’s home folder, (e.g. ~/<username>/dev/tutorial/).

In your terminal, go to your tutorial folder, and run the following command to configure a new DDEV project there:

ddev config --project-name=tutorial --project-type=php --php-version=8.0

Then run the following command to download the craftcms/craft (opens new window) starter project contents, and install its Composer dependencies (namely craftcms/cms (opens new window)):

ddev composer create -y craftcms/craft

At the end of that command, it will ask whether you’d like to begin the setup. Go ahead and answer yes. Then answer the subsequent prompts as follows:

  • Which database driver are you using? (mysql or pgsql)mysql (default)
  • Database server name or IP addressdb
  • Database port3306 (default)
  • Database usernamedb
  • Database passworddb
  • Database namedb
  • Database table prefix(leave blank)

Answer yes to the prompt on whether to install Craft now, and answer the remaining prompts as you like. The only one that matters is Site URL, which you should answer with

Now set your DDEV web server’s document root to the web/ folder like so:

ddev config --docroot=web

Finally, you’re ready to start up your new web server:

ddev start

In your browser, you should be able to head over to (opens new window) and see the Craft CMS welcome template.
Screenshot of the Craft CMS welcome template