Installing Bedrock

Requirements

Installation

  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 (http://example.com)
  • WP_SITEURL - Full URL to WordPress including subdirectory (http://example.com/wp)
  • 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 http://example.com/wp/wp-admin

Multisite

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.

Join over 5,800 subscribers on our newsletter to get the latest Roots updates, along with occasional tips on building better WordPress sites.

Looking for WordPress plugin recommendations, the newest modern WordPress projects, and general web development tips and articles?

“Easily the best WordPress email I get.” Colin OBrien

Follow us on Twitter @rootswp

Ready to checkout?