Drupal quick-start demo on your own hosting

Last updated on
12 July 2026

The quick-start command is intended only for launching a local demo version of Drupal in your own bespoke setup. Consider the recommended routes for:

The only requirement for the quick-start command is that PHP must be installed. Once 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 the 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 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 assist with this step.

Step 2 - Get Drupal

Option A - Using Composer

Paste the line below into your command line to download and extract the Drupal package with Composer:

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

Option B - Using Git and Composer

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

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

Step 3 - Install Drupal demo using quick-start

Use the quick-start command to install and start the Umami food magazine demonstration site within Drupal:

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 .ht.router.php instead:

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

Help improve this page

Page status: No known problems

You can: