Skip to content

Installation

Jump to bottom
Mischa Braam edited this page Feb 16, 2024 · 15 revisions

Move from Laravel Valet to Valet+

To install Valet+ after having installed Laravel's Valet. Please use the following steps.

  1. Uninstall Laravel Valet with valet uninstall --force.
  2. Follow the removal instructions.
  3. Remove the Valet package composer global remove laravel/valet.
  4. Continue with Valet+ installation instructions.

Installing Valet+

⚠️ Valet+ requires macOS and Homebrew. Before installation, you should make sure that no other programs such as Apache or Nginx are binding to your local machine's port 80.

⚠️ Valet+ requires Composer to be installed.

To get started, you first need to ensure that Homebrew is up-to-date using the update command:

brew update

Next, you should use Homebrew to install PHP 8.1 (using shivammathur/php):

brew tap shivammathur/php
brew install shivammathur/php/[email protected]
brew link [email protected] --force
brew services restart [email protected]

Install Valet+ 3 with composer:

composer global require weprovide/valet-plus

Finally, you may execute the Valet+ install command. This will configure and install Valet+, Nginx, DnsMasq, Mailhog and other services. In addition, use --help to see all installation options.

valet-plus install

The daemons Valet+ depends on, will be configured to launch when your system starts. Once Valet+ is installed, try pinging any *.test domain on your terminal using a command such as ping foobar.test. If Valet+ is installed correctly you should see this domain responding on 127.0.0.1.

RDBMS

When installing you can use parameters to choose which database application you wish to use.

  • valet-plus install (default: installs mysql 5.7)
  • valet-plus install --with-mysql80 (installs mysql 8.0)
  • valet-plus install --with-mysql81 (installs mysql 8.1)
  • valet-plus install --with-mariadb (installs mariadb)

Binaries

By default all binaries (wp-cli, drush, magerun, magerun2) will be installed. You can choose which binary to install by providing them with the parameter --with-binary (or short -b) for each desired binary. For example;

valet-plus install -b magerun -b magerun2
Clone this wiki locally