Skip to content

Local Development

Radicle comes with configuration for two local development setups out of the box:

Laravel Valet also supports Radicle sites with no config required.

These tools aren't a requirement to use Radicle. Any local development tool can be used with as long as you set your document root to the public directory. You will also need to:

  1. Run yarn && yarn build
  2. Run composer install
  3. Copy .env.example to .env and update the environment variables

# Lando

To use Lando with Radicle:

  1. In bud.config.js: Replace http://radicle.test with
  2. Run yarn && yarn build
  3. Run lando start
  4. Visit

You can run lando login to generate a passwordless wp-admin login URL (WordPress must first be installed).

# Trellis

Run php .radicle-setup/trellis.php to grab the latest version of Trellis and apply the necessary modifications for Radicle. After you've ran this script, navigate to the Trellis directory to init and start your project:

$ php .radicle-setup/trellis.php
$ cd trellis/
$ trellis init
$ trellis up

Open bud.config.js and replace http://radicle.test with your local development URL. For example, if you used as the domain name during the setup then your URL would be http://example.test. If you are unsure what this URL is, open trellis/group_vars/development/wordpress_sites.yml and use the canonical URL.

Then you will want to run yarn && yarn build before visiting your site at http://example.test/.

You can remove the .radicle-setup/ directory after you've ran the Trellis script, or if you aren't planning to use Trellis.

Make sure to commit the changes to the repo as there will now be a trellis/ folder.

Last updated

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