Skip to content

What's new in valet.sh 3.x

Warning

valet.sh 3.x is still under active development - this page and the rest of the 3.x documentation may change without notice. Use the version selector above to switch back to the current stable 2.x documentation.

Coming from valet.sh 2.x?

3.x contains breaking changes and does not migrate any data. Follow the Upgrade from 2.x to 3.x guide before you switch.

Data services (MySQL, MariaDB, Elasticsearch, OpenSearch, Redis, Valkey, RabbitMQ, Mailpit) no longer run as native packages but as containers - Apple Containers on macOS, Podman with systemd user units on Ubuntu. PHP, Nginx, dnsmasq, Composer, Node.js and Magerun still run natively.

The second big change is that most services are now optional and installed/removed on demand instead of being bundled with every installation:

  • Only a small essential baseline (nginx, dnsmasq, mailpit) is installed automatically - see Services.
  • Everything else (PHP, MySQL, MariaDB, Elasticsearch, OpenSearch, Redis, Valkey, RabbitMQ, Node.js, Composer, Magerun) is installed only when you ask for it, via install.
  • New uninstall command to remove a service you no longer need.
  • init-instance automatically installs whatever service versions your project's .valet-sh.yml declares, if they aren't installed yet.
  • Mailhog has been fully replaced by Mailpit, which is now part of the essential baseline.

See also Changelog.

What's new in valet.sh 2.x

Here is a short list of all the new main features of valet.sh 2.x (compared to 1.x).

  • macOS Support
  • parallel installation of MySQL 5.7 and 8.0
  • New "service" command:
    • Manage the state of each service (enable/disable)
    • Manage a default service for PHP, Elasticsearch and MySQL (more information)