Installing Bedrock



  1. Create a new project - composer create-project roots/bedrock
  2. Copy .env.example to .env and update environment variables:
  • DB_NAME - Database name
  • DB_USER - Database user
  • DB_PASSWORD - Database password
  • DB_HOST - Database host
  • WP_ENV - Set to environment (development, staging, production)
  • WP_HOME - Full URL to WordPress home (
  • WP_SITEURL - Full URL to WordPress including subdirectory (
  • AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT, NONCE_SALT - Generate with wp-cli-dotenv-command or from the Roots WordPress Salt Generator
  1. Add theme(s) in web/app/themes as you would for a normal WordPress site.
  2. Set your site vhost document root to /path/to/site/web/ (/path/to/site/current/web/ if using deploys)
  3. Access WP admin at


Bedrock is multisite network compatible, but needs the multisite-url-fixer mu-plugin on subdomain installs to make sure admin URLs function properly. This plugin is not needed on subdirectory installs, but will work well with them.

Run composer require roots/multisite-url-fixer to install the package. It will automatically install as an mu-plugin thanks to the mu-plugins autoloader.