Hello, dev.. 👋

If you often develop Laravel applications, you will know Valet. Well, valet is a tool that helps to create local development, but valet only works on Mac OS. So in this tutorial, we will try to use Valet but on Linux.

The Linux I’m currently using is Ubuntu 22.04 LTS, so if your Linux OS is the same or your Linux is another Ubuntu-based Linux, you can follow this tutorial.

The Valet that we will use is Valet Linux which is maintained by cpriego.

Add PPA to Ubuntu

Before starting the installation, we add the PPA repository to our Ubuntu. We will use the PHP and Nginx packages from Ondřej Surý. He is a Debian Developer and voluntarily develops Apache, PHP, and Nginx packages following official updates.

sudo add-apt-repository ppa:ondrej/php
sudo add-apt-repository ppa:ondrej/nginx

Then update the source list with the following command

sudo apt update

Install Nginx

Valet uses nginx, so we install nginx first.

sudo apt install nginx

Once installed, open localhost and it will display the Nginx homepage.

Install PHP

Because we are using Nginx, we will install php-fpm using the following command. By default, it will install the latest version of PHP. We will also install the curl PHP Extension.

sudo apt install php-fpm php-curl php-mysql

You also install a certain version of PHP, for example, version 8.0, adding the version behind PHP.

sudo apt install php8.0-fpm php8.0-curl php8.0-mysql

Then if you have several versions of PHP installed, and want to change them, use the following command

sudo update-alternatives --config php

Next, to check the PHP version, you can use the following command

php -v

Install Composer

To install Composer, you can follow the documentation on the composer website at https://getcomposer.org/download/

Install Valet Requirements

According to valet requirements for Linux Ubuntu, you must install the following tools.

sudo apt-get install network-manager libnss3-tools jq xsel dnsmasq inotify-tools

Install Valet

Run the following command to add the valet Linux repository to composer

composer global require cpriego/valet-linux

Then run the following command to install valet

valet install

If the valet install command is not executed, then you need to run the following command in the terminal

echo "export PATH=$PATH:$HOME/.config/composer/vendor/bin" >> ~/.bashrc

Or the following command if you use zsh in your terminal

echo "export PATH=$PATH:$HOME/.config/composer/vendor/bin" >> ~/.zshrc

Valet Command

There are several valet commands that you can use, such as:

valet park
valet forget
valet link
valet unlink

valet park used to add directories to the valet path so that each folder can be accessed using foldername.test

valet forget reverse valet park to remove the directory from the valet path

valet link to make folders individually accessible with foldername.test

valet unlink reverse valet link to remove the link from valet

Troubleshoot

To find out if valet is running well with the command

valet status

If it says Nginx is stopped… then you need to activate Nginx first

sudo systemctl start nginx

Good luck 🍻