Install Laravel Valet on Linux Ubuntu
Tags: linux, ubuntu, laravel, valet
Published: 2024-03-18 04:52:40

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](https://cpriego.github.io/valet-linux/) which is maintained by [cpriego](https://github.com/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/](https://getcomposer.org/download/)

## Install Valet Requirements

According to valet requirements for [Linux Ubuntu](https://cpriego.github.io/valet-linux/requirements#ubuntu-and-derivates), 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 Linux Ubuntu](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ial53048vs6rxawze8vq.png)

## 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 🍻