Skip to content


Create a database.


  • drush sql:create. Create the database for the current site.
  • drush @site.test sql-create. Create the database as specified for @site.test.
  • drush sql:create --db-su=root --db-su-pw=rootpassword --db-url="mysql://drupal_db_user:drupal_db_password@". Create the database as specified in the db-url option.


  • --db-su=DB-SU. Account to use when creating a new database.
  • --db-su-pw=DB-SU-PW. Password for the db-su account.
  • --database[=DATABASE]. The DB connection key if using multiple connections in settings.php. [default: default]
  • --target[=TARGET]. The name of a target within the specified database connection. [default: default]
  • --db-url=DB-URL. A Drupal 6 style database URL. For example mysql://root:pass@localhost:port/dbname
  • --show-passwords. Show password on the CLI. Useful for debugging.


  • sql-create


  • An argument or option with square brackets is optional.
  • Any default value is listed at end of arg/option description.
  • An ellipsis indicates that an argument accepts multiple values separated by a space.