PHPackages                             eunus/valet-ubuntu - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. eunus/valet-ubuntu

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

eunus/valet-ubuntu
==================

A more enjoyable local development experience for Ubuntu.

v2.0.2(9y ago)04MITPHPPHP &gt;=5.5.9

Since May 15Pushed 9y ago1 watchersCompare

[ Source](https://github.com/eunushosen/valet-ubuntu)[ Packagist](https://packagist.org/packages/eunus/valet-ubuntu)[ RSS](/packages/eunus-valet-ubuntu/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (7)Versions (8)Used By (0)

Valet *for Ubuntu*
==================

[](#valet-for-ubuntu)

[![Build Status](https://camo.githubusercontent.com/d5a1b61b524884dcb6750f5b8602395a73e6c41180131ee262e4d6466a08ee02/68747470733a2f2f7472617669732d63692e6f72672f6370726965676f2f76616c65742d7562756e74752e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/cpriego/valet-ubuntu)[![Total Downloads](https://camo.githubusercontent.com/b2322843175e916e6d40e8afae336ce4051bad6a241144a310c20cbd8afd7940/68747470733a2f2f706f7365722e707567782e6f72672f6370726965676f2f76616c65742d7562756e74752f646f776e6c6f6164732e737667)](https://packagist.org/packages/cpriego/valet-ubuntu)[![Latest Stable Version](https://camo.githubusercontent.com/b7e469f3434d79dfa01a6e8c5b80a3ed2d0a4624c58401fb6d1a9fa77862909a/68747470733a2f2f706f7365722e707567782e6f72672f6370726965676f2f76616c65742d7562756e74752f762f737461626c652e737667)](https://packagist.org/packages/cpriego/valet-ubuntu)[![Latest Unstable Version](https://camo.githubusercontent.com/0dd0280fc26027d68c1b63cd1715d13f87e61ae0a13a6f6421df916af6fadece/68747470733a2f2f706f7365722e707567782e6f72672f6370726965676f2f76616c65742d7562756e74752f762f756e737461626c652e737667)](https://packagist.org/packages/cpriego/valet-ubuntu)[![License](https://camo.githubusercontent.com/eb0129db63d38f32c4e9a6ee836bcee82cad9be9bf68b582ac49a1cfebc9d8cc/68747470733a2f2f706f7365722e707567782e6f72672f6370726965676f2f76616c65742d7562756e74752f6c6963656e73652e737667)](https://packagist.org/packages/cpriego/valet-ubuntu)

Introduction
------------

[](#introduction)

Valet *for Ubuntu* is a Laravel development environment for Ubuntu minimalists. No Vagrant, no `/etc/hosts` file. You can even share your sites publicly using local tunnels. *Yeah, we like it too.*

Valet *for Ubuntu* configures your system to always run Nginx in the background when your machine starts. Then, using [DnsMasq](https://en.wikipedia.org/wiki/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 *for Ubuntu* 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.

Official Documentation
----------------------

[](#official-documentation)

Documentation for Valet can be found on the [Laravel website](https://laravel.com/docs/valet).

Upgrading To Valet 2.0
----------------------

[](#upgrading-to-valet-20)

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.

Requirements
------------

[](#requirements)

- Ubuntu &gt;= 14.04
- Dependencies: `sudo apt-get install libnss3-tools jq xsel`
- PHP &gt;= 5.6
- 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**

Installation
------------

[](#installation)

1. `composer global require cpriego/valet-ubuntu`
2. `valet install`

Caveats
-------

[](#caveats)

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 and PhpFPM config files. If you've previously configured Nginx please backup your files before upgrading.

Usage
-----

[](#usage)

**`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 Ubuntu*** services.

Update
------

[](#update)

To update your Valet package just run: `composer global update`

F.A.Q.
------

[](#faq)

**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.

[You can check it here](https://www.valentina-db.com/en/valentina-studio-overview)

[And download it here](https://www.valentina-db.com/en/studio/download)

*\* I know it is GNU/Linux but is too long and it confuses people even more*

License
-------

[](#license)

Laravel Valet is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 70.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~34 days

Recently: every ~46 days

Total

7

Last Release

3488d ago

Major Versions

v1.1.16 → v2.0.12016-12-11

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/25835508?v=4)[Mohammed Eunus Ali](/maintainers/eunus)[@eunus](https://github.com/eunus)

---

Top Contributors

[![taylorotwell](https://avatars.githubusercontent.com/u/463230?v=4)](https://github.com/taylorotwell "taylorotwell (253 commits)")[![cpriego](https://avatars.githubusercontent.com/u/6462826?v=4)](https://github.com/cpriego "cpriego (46 commits)")[![adamwathan](https://avatars.githubusercontent.com/u/4323180?v=4)](https://github.com/adamwathan "adamwathan (8 commits)")[![lucasmichot](https://avatars.githubusercontent.com/u/513603?v=4)](https://github.com/lucasmichot "lucasmichot (5 commits)")[![jasonvarga](https://avatars.githubusercontent.com/u/105211?v=4)](https://github.com/jasonvarga "jasonvarga (5 commits)")[![KennedyTedesco](https://avatars.githubusercontent.com/u/999232?v=4)](https://github.com/KennedyTedesco "KennedyTedesco (4 commits)")[![aaemnnosttv](https://avatars.githubusercontent.com/u/1621608?v=4)](https://github.com/aaemnnosttv "aaemnnosttv (4 commits)")[![igorpan](https://avatars.githubusercontent.com/u/2479869?v=4)](https://github.com/igorpan "igorpan (3 commits)")[![FoxGroveMedia](https://avatars.githubusercontent.com/u/2521396?v=4)](https://github.com/FoxGroveMedia "FoxGroveMedia (3 commits)")[![jerguslejko](https://avatars.githubusercontent.com/u/4470539?v=4)](https://github.com/jerguslejko "jerguslejko (3 commits)")[![vmitchell85](https://avatars.githubusercontent.com/u/1248035?v=4)](https://github.com/vmitchell85 "vmitchell85 (2 commits)")[![EunusHosen](https://avatars.githubusercontent.com/u/1550104?v=4)](https://github.com/EunusHosen "EunusHosen (2 commits)")[![jpscharf](https://avatars.githubusercontent.com/u/1039984?v=4)](https://github.com/jpscharf "jpscharf (2 commits)")[![pespantelis](https://avatars.githubusercontent.com/u/9113554?v=4)](https://github.com/pespantelis "pespantelis (2 commits)")[![janhohner](https://avatars.githubusercontent.com/u/649895?v=4)](https://github.com/janhohner "janhohner (1 commits)")[![Keoghan](https://avatars.githubusercontent.com/u/6714599?v=4)](https://github.com/Keoghan "Keoghan (1 commits)")[![lifesign](https://avatars.githubusercontent.com/u/2189610?v=4)](https://github.com/lifesign "lifesign (1 commits)")[![jackmcdade](https://avatars.githubusercontent.com/u/44739?v=4)](https://github.com/jackmcdade "jackmcdade (1 commits)")[![mattdfloyd](https://avatars.githubusercontent.com/u/185187?v=4)](https://github.com/mattdfloyd "mattdfloyd (1 commits)")[![mattstauffer](https://avatars.githubusercontent.com/u/151829?v=4)](https://github.com/mattstauffer "mattstauffer (1 commits)")

---

Tags

laravelubuntuzondawwdhhdxenial16.04

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/eunus-valet-ubuntu/health.svg)

```
[![Health](https://phpackages.com/badges/eunus-valet-ubuntu/health.svg)](https://phpackages.com/packages/eunus-valet-ubuntu)
```

###  Alternatives

[laravel/valet

A more enjoyable local development experience for Mac.

2.6k918.2k14](/packages/laravel-valet)[cpriego/valet-linux

A more enjoyable local development experience for Linux.

1.5k137.2k](/packages/cpriego-valet-linux)[genesisweb/valet-linux-plus

Advanced local development experience for Linux.

18415.8k](/packages/genesisweb-valet-linux-plus)[ycodetech/valet-windows

A more enjoyable local development experience for Windows. A Windows port of the popular Laravel Valet and a fork of cretueusebiu/valet-windows, with new features.

451.7k](/packages/ycodetech-valet-windows)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
