Valet Linux is a Laravel development environment for Linux minimalists. No Vagrant, no /etc/hosts file. You can even share your sites publicly using local tunnels. Yeah, we like it too.
Valet Linux configures your system to always run Nginx in the background when your machine starts. Then, using DnsMasq, Valet proxies all requests on the *.dev domain to point to sites installed on your local machine.
In other words, a blazing fast Laravel development environment that uses roughly 7mb of RAM. Valet Linux isn't a complete replacement for Vagrant or Homestead, but provides a great alternative if you want flexible basics, prefer extreme speed, or are working on a machine with a limited amount of RAM.
Documentation for Valet can be found on the Laravel website.
Valet 2.0 transitions Valet's underlying web server from Caddy to Nginx. Before upgrading to this version you should run the following commands to stop and uninstall the existing Caddy daemon:
valet stop
valet uninstall
Next, you should upgrade to the latest version of Valet. Depending on how you installed Valet, this is typically done through Git or Composer. Once the fresh Valet source code has been downloaded, you should run the install command:
valet install
valet restart
After upgrading, it may be necessary to re-park or re-link your sites.
- PHP >= 5.6
- Ubuntu (and derivates), Fedora (and derivates) or Arch Linux (and derivates)
- PHP Packages:
php*-cli php*-curl php*-mbstring php*-mcrypt php*-xml php*-zip - Optional PHP Packages:
php*-sqlite3 php*-mysql php*-pgsql
Replace the star (*) with your php version
- Ubuntu >= 14.04
- Dependencies:
sudo apt-get install libnss3-tools jq xsel
Regarding the supported Ubuntu version:
- LTS. Will get 4 year support (meaning only the latest 2 releases).
- Non-LTS. Only get 9 months. You should update anyway.
- Development. Only if I have the time. Development version are extremely unstable and prone to change. It is very difficult to isolate any issue.
- Fedora >= 24
- Dependencies:
dnf install nss-tools jq xsel
Valet Linux expects a sudo user with the $HOME environment variable set. Fedora users are expected to have knowledge of SELinux and how to configure it or disable it while Valet makes changes to the configuration files.
To set the $HOME environment variable when using sudo in Fedora:
- Open your sudoers file with
visudo - Find the lines with the text
Defaults env_keep += - Append
Defaults env_keep += "HOME"after those lines - Save your changes
Temporarily (until reboot): sudo setenforce 0
Permanent:
- Open
/etc/selinux/config - Change
SELINUX=enforcingtoSELINUX=permissive - Reboot
composer global require cpriego/valet-linuxvalet install
Because of the way Firefox and Chrome/Chromium/Opera/Any.Other.Blink.Based.Browser manages certificates in Linux the experience when securing a site might not be as smooth as it is in OSX.
Whenever you secure a site you'll need to restart your testing browser so that it can trust the new certificate and you'll have to do the same when you unsecure it.
If you have secured a domain you will not be able to share it through Ngrok.
Valet 2.0 will overwrite the Nginx, PhpFPM config files. If you've previously configured Nginx please backup your files before upgrading.
NetworkManager loves being involved in everything network-related including DNS. We configure DnsMasq through NetworkManager so your network connection might drop whenever you install Valet or change the domain. To solve this simply reconnect to your network.
valet park
You can use valet park inside the directory where you store your projects (like Sites or Code) and then you can open http://projectname.dev in your browser. This command will allow you to access all the projects in the parked folder.
valet link
If you just want to serve a single site you can use valet link [your-desired-url] and then open http://your-desired-url.dev in the browser.
valet status
To check the status of the Valet for Linux services.
To update your Valet package just run: composer global update
Why can't I run valet install?
Check that you've added the .composer/vendor/bin directory to your PATH in either ~/.bashrc or ~/.zshrc.
What about the Database?
Well, your choice! You could use the superlight SQLite sqlite3, the extremely versatile MariaDB/MySQL mariadb-server or mysql-server or even the powerful PostgreSQL postgresql. Just don't forget to install the corresponding php package for it.
Any other tips?
Oh yeah!, for those looking for a beautiful looking Database management tool like Sequel Pro but for Linux* try out Valentina Studio, it's free, multiplatform and supports all of the databases mentioned above.
* I know it is GNU/Linux but is too long and it confuses people even more
Laravel Valet is open-sourced software licensed under the MIT license