Drupal Quick Start Command

Last updated on
15 December 2024

The quick-start command is intended only for launching a local demo version of Drupal.

The only requirement for the quick-start command is that PHP must be installed. One that is complete, the quick-start command will install and run Drupal using PHP's built-in web server on your own computer.

If you need to install Drupal for production, see instructions in the rest of this guide. If you need to install Drupal for development go to the install Drupal using DDEV in the Local server setup guide.

Step 1 - install PHP

Read the PHP requirements for to find the version of PHP required by currently supported versions of Drupal.

You can install PHP using the standard method for your operating system. Also, install the following extensions;

php-cli php-curl php-gd php-mbstring php-sqlite3 php-xml

There are many on-line resources for installing PHP to refer to assist with this step.

Step 2 - Get Drupal

Option A - Install using composer

Paste the line below into your command line to download and extract the Drupal package with composer and start it:

composer create-project drupal/recommended-project my-site && cd my-site

Option B - Install using Git and composer

Paste the line below into your command line to download and extract the Drupal package with Git and start it:

git clone https://git.drupalcode.org/project/drupal.git my-site && cd my-site && composer install

Step 3 - Quick start

php -d memory_limit=256M core/scripts/drupal quick-start demo_umami

Installation can take a minute or two. A successful installation will result in opening the new site in your browser and outputting relevant information in the terminal.

18/18 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓]
Congratulations, you installed Drupal!
Username: admin
Password: PM_kRw1i1xtPGeoT
Drupal development server started: <http://127.0.0.1:8888>
This server is not meant for production use.
One time login url: <http://127.0.0.1:8888/user/reset/1/1536313723/49dSy9t55aC-zaOwP5DcQo8Sa_ZLnRkvXpd3K8ndHnU/login>
Press Ctrl-C to quit the Drupal development server.

For a list of available options that you may need to configure quick-start, run:

$ php ./core/scripts/drupal quick-start --help

Troubleshooting

Sometimes, after successfully installing and running the quick-start demo, you may encounter a frozen page.

The solution is to quit the PHP server and use the .ht.router.php instead:

php -S localhost:8888 .ht.router.php

Help improve this page

Page status: No known problems

You can: