Detailed guide. An unofficial adaptation of User Guide 3.1. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Chapter 3 overview · Next: 3.2 Server Requirements
Goal
Plan a new installation before downloading files. This is not an instruction to overwrite or reinitialize an existing site.
Prerequisites
The source expects server/hosting setup and database-creation knowledge. Review requirements , installation methods and DDEV .
Our preparation note: record whether the destination is empty or contains existing data. Distinguish URL, project directory, web root and database. Do not put credentials into public notes.
Adapted preparation process
Choose a download and installation method; configure hosting and its URL; verify basic page delivery; create the site database and a user with access; download the files; then proceed to the installer if installation has not already happened.
Our qualification: database access refers to the site database, not blanket server administration. With recommended-project, the project directory and web/ are distinct. DDEV manages parts of the local setup, so do not duplicate generic hosting steps unnecessarily.
Our verification checklist
| Item | Check |
|---|---|
| Destination | New versus existing site |
| URL | Correct working environment |
| Directories | Project root versus document root |
| Database | Correct database and account, without repurposing existing data |
| Method | Whether a provider or DDEV already installed the site |
Connection to changes
Read the PHP qualification and project-template note . Planning begins in Chapter 2 .
Sources, credits and changes
Source: Drupal User Guide 3.1 ↗ . Contributors and source links listed in its Attributions: Drew Gorton ↗ · Michael Lenahan ↗ · erdfisch · Jennifer Hodgdon ↗ · Jojy Alphonso ↗ · Red Crackle . Refer to the source for writing, editing and adaptation roles, and to the guide-wide credits ↗ .
Copyright remains with the individual contributors; the official copyright page ↗ states © 2015–2025. Changes include reorganized explanations and procedures, our preparation and verification examples, troubleshooting notes, source-interpretation qualifications and release references. Original screenshots and videos are not reproduced. This adapted text is shared under CC BY-SA 2.0 . It is not an official edition or endorsement. This notice does not license unrelated articles or the site design.
Chapter navigation
Chapter 3 overview · Next: 3.2 Server Requirements
Chapter 2 details · Chapter 4 · All chapters · Search official information