Skip to content
Roots

Bedrock Docs

Server Configuration

Bedrock can run on any webserver that supports Composer and PHP >= 7.1. The document root for your site must be pointed to Bedrock's web folder.

Nginx configuration for Bedrock

If you aren't using a Nginx-based setup that already supports Bedrock, such as Valet or Trellis, you'll need to configure Nginx with the following rules:

server { listen 80; server_name example.com; root /srv/www/example.com/web; index index.php index.htm index.html; # Prevent PHP scripts from being executed inside the uploads folder. location ~* /app/uploads/.*.php$ { deny all; } location / { try_files $uri $uri/ /index.php?$args; } }

Nginx multisite config

Multisite installations on Nginx need additional rewrites depending on the type of multisite install.

Subdomain multisite rewrites

rewrite ^/(wp-.*.php)$ /wp/$1 last; rewrite ^/(wp-(content|admin|includes).*) /wp/$1 last;

Subfolder multisite rewrites

if (!-e $request_filename) { rewrite /wp-admin$ $scheme://$host$uri/ permanent; rewrite ^(/[^/]+)?(/wp-.*) /wp$2 last; rewrite ^(/[^/]+)?(/.*.php) /wp$2 last; }

Apache configuration for Bedrock

Make sure the DocumentRoot is set to the web folder:

<VirtualHost *:80> DocumentRoot /var/www/html/bedrock/web DirectoryIndex index.php index.html index.htm <Directory /var/www/html/bedrock/web> Options -Indexes # .htaccess isn't required if you include this <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^index.php$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.php [L] </IfModule> </Directory> </VirtualHost>

You can also add the suggested .htaccess file from WordPress at web/.htaccess:

Managed WordPress hosts and Bedrock

If you're using a supported WordPress host such as Kinsta, then contact support and ask them to set your document root to the web folder.

Sometimes you can't change the document root on hosted web server. In this case, you can create an .htaccess file at the root of your project with the following content:

Contributors

Last updated

Help us improve this page.

This is a WordPress site, but the Roots docs are powered by Acorn & Laravel routes instead of from a WordPress post type or page. If you’re interested in the ability create WordPress virtual pages powered by Laravel routes in a routes/web.php file, you might like Radicle.

Support Roots

Help us continue to build and maintain our open source projects. We’re a small team of independent developers and every little bit helps.

Sponsor Roots on GitHub

Getting Started

The Basics

Digging Deeper

Guides