Skip to content

Upgrade Guide

In this upgrade, several significant changes have been made. Please follow the steps below to ensure a smooth transition to Valet Linux Plus v2.0.


To upgrade to Valet Linux Plus v2.0.1, ensure your system meets the following requirements:

  • PHP version: PHP 8.2 or higher.

Make sure your environment includes the required PHP extensions. Install or update PHP and the necessary extensions using the following command:

sudo apt install php8.2-cli php8.2-common php8.2-curl php8.2-mbstring php8.2-opcache php8.2-readline php8.2-xml php8.2-zip php8.2-mysql php8.2-gd

Major changes:

Home directory:

The configuration directory has moved from ~/.valet to ~/.config/valet. This migration will be handled automatically during the upgrade process.

Isolation commands:

New commands have been added to support deprecated PHP versions for specific websites:

  • valet isolate {phpVersion} --site=siteName.test --secure
  • valet unisolate --site=siteName.test
  • valet isolated

For more information on these commands, visit the isolation version documentation.

Use command:

The valet use command will no longer install older PHP versions. Please use the isolate commands to install specific PHP versions for sites.

PHP bash file:

A new php bash file has been added at /usr/local/bin/php. This helper file supports isolated PHP versions. When navigating to an isolated directory, it will run the isolated PHP version, and when navigating to any other directory, it will run the system's default PHP version.

Minor changes:

  • Implemented termwind and console components package to enhance the output of terminal messages.
  • Added unit tests for all relevant classes.


  • Removed the /valet-sites path as it requires additional support in the new version. It will be reintroduced in a future release.
  • Removed subdomain commands, as they are equivalent to the valet link command in v2.0.

Upgrade steps:

Update Valet Linux Plus:

To update to the latest version, run the following Composer command:

composer global require genesisweb/valet-linux-plus:v2.0.1 -W

Run migration process:

After updating, run the valet command to initiate the migration process, which will move your configuration directory to the new location.


Complete the installation:

Finally, run the valet install command to complete the update process and ensure all components are properly configured.

valet install

By following these steps, you will ensure that your Valet Linux Plus setup is updated to version 2.0 with the new configuration directory and the required PHP version.