Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Laravel Valet For Windows Latest Stable Version License Analytics

Laravel Valet for Windows


This is Windows version of Laravel Valet. Valet is a Laravel development environment for minimalists. This Windows version brings even less software than Valet for Mac and you still can share your sites publicly using local tunnels.

Laravel Valet for Windows configures your PC to run Caddy on demand. Then, using c:\Windows\System32\drivers\etc\hosts file, 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 les than 1mb of RAM (see RAM usage). Valet 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.

Please, keep in mind, an arbitrary php application won't work in Valet, you need to support them via special drivers. Obviously Laravel is supported, as well, as many others popular php headliners, like Symfony, WordPress, Joomla, etc. See the full list here

Important Notes

  • Set C:\Windows\System32\drivers\etc\hosts file permissions to allow full control for current user/administrator
  • Windows 64-bit is supported (if anyone still needs 32-bit, please, make an issue)
  • Run git-bash as Administrator, as only Administrator can handle symlinks on Windows
  • Sometimes caddy server just stops working (502 Bad Gateway), without any reason, sometimes it stops when the Internet connection is lost, manually running valet restart always helps

Quick How To

This will set up and run a new Laravel application named blog, accessible on localhost Only php and composer are required to run Valet for Windows. See advanced how to if you don't have them yet.

You must use git-bash or similar shell. This doesn't work in standard Windows cmd, native bash will soon come to Windows, fingers crossed.

composer global require laravel/installer vitr/valet4windows
mkdir ~/Sites && cd ~/Sites
laravel new blog
valet install
valet park
valet scan 
valet start
cd blog && valet open 

Advanced How To

Install php & composer

As we run php with Caddy in FastCGI mode download NTS (Non Thread Safe) version (x86 or x64) from Extract downloaded archive to C:\php. Copy php.ini-development as php.ini and open it in a text editor. Uncomment extension path for Windows

 ; Directory in which the loadable extensions (modules) reside.
 ; extension_dir = "./"
 ; On windows:
  extension_dir = "ext"

uncomment required extensions, e.g.

; Windows Extensions
; Note that ODBC support is built in, so no dll is needed for it.
; Note that many DLL files are located in the extensions/ (PHP 4) ext/ (PHP 5+)
; extension folders as well as the separate PECL DLL download (PHP 5+).
; Be sure to appropriately set the extension_dir directive.
;extension=php_exif.dll      ; Must be after mbstring as it depends on it
;extension=php_oci8_12c.dll  ; Use with Oracle Database 12c Instant Client

Keep in mind Laravel's server requirement

Tokenizer PHP Extension is included by default in all Windows builds
Add php path (e.g. C:\php) to your system path.

Install composer from Composer-Setup.exe windows installer does all the work for you, including putting the composer bin folder in your system path, so, later you can easily use commands like laravel or valet.

Install Composer packages

From this point use git-bash or or other bash compatible terminal, as windows cmd doesn't work for us here. It's too much work to completely rewrite all the valet commands in windows shell and hopefully bash support will be included officially in Windows 10 very soon.

composer global require laravel/installer vitr/valet4windows

Updating your hosts file

valet scan

it updates your hosts file C:\Windows\System32\drivers\etc\hosts, so, you have to change its properties to allow full control for current user.

Running Valet

If you're on Windows there is a chance that your ports 80 and 443 are already occupied by ISS or Skype. Read more how to disable ISS here and how to fix Skype here

Open Laravel site

cd blog && valet open (will open in chrome)

List of supported applications and frameworks

Unresolved Issues


I see the benefits of only integration testing here. I would test each valet command and check the outcomes. Unfortunately, travis doesn't support Windows, so, I perform them manually on Windows machine. Later on, I may try


  • compile caddy with this Minimal windows service stub
  • update valet drivers
  • demo how to install SSL certificates (so much fun:)
  • Implement the same tests as for Mac and maybe some more
  • Clean up all the OS X leftovers
  • update caddyserver (Latest release v0.9.0)
  • Combine scan with park, forget, link, unlink
  • Move caddy exec to bin, Caddyfile config to ~/.valet
  • fix larawhale names in readme
  • move the history into a standalone history file (see
  • Port all original mac Valet commands
    • domain
    • fetch-share-url
    • forget
    • help
    • install
    • link (requires run git-bash as administrator)
    • links
    • list
    • logs
    • on-latest-version
    • open
    • park
    • paths
    • restart
    • secure, to get rid of in-browser warning you have to manually install certificate (double click on ~.valet\Certificates\ and install it in the root)
    • share
    • start
    • stop
    • uninstall
    • unlink
    • unsecure
    • which