{"id":13669157,"url":"https://github.com/vitr-archive/valet4windows","last_synced_at":"2026-01-11T07:04:02.137Z","repository":{"id":62544754,"uuid":"60585879","full_name":"vitr-archive/valet4windows","owner":"vitr-archive","description":"Windows version of Laravel Valet","archived":false,"fork":false,"pushed_at":"2016-12-15T12:51:00.000Z","size":23524,"stargazers_count":63,"open_issues_count":4,"forks_count":5,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-08-02T08:07:46.111Z","etag":null,"topics":["laravel","php","valet","windows"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vitr-archive.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-07T05:52:16.000Z","updated_at":"2024-08-02T08:07:46.112Z","dependencies_parsed_at":"2022-11-02T22:00:30.813Z","dependency_job_id":null,"html_url":"https://github.com/vitr-archive/valet4windows","commit_stats":null,"previous_names":["vitr/valet4windows"],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitr-archive%2Fvalet4windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitr-archive%2Fvalet4windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitr-archive%2Fvalet4windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitr-archive%2Fvalet4windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vitr-archive","download_url":"https://codeload.github.com/vitr-archive/valet4windows/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251077102,"owners_count":21532607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","php","valet","windows"],"created_at":"2024-08-02T08:01:04.396Z","updated_at":"2025-04-27T01:32:42.833Z","avatar_url":"https://github.com/vitr-archive.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# Laravel Valet For Windows [![Latest Stable Version](https://poser.pugx.org/vitr/valet4windows/v/stable?format=flat-square)](https://packagist.org/packages/vitr/valet4windows) [![License](https://poser.pugx.org/vitr/valet4windows/license.svg?format=flat-square)](https://packagist.org/packages/vitr/valet4windows) [![Analytics](https://vitr-analytics.appspot.com/UA-75628680-1/valet4windows?flat\u0026useReferer)](https://github.com/vitr/google-analytics-beacon)\n\n![Laravel Valet for Windows](https://cloud.githubusercontent.com/assets/2770290/17275120/52b52a80-5740-11e6-9e5a-22c4dfa5a977.png)\n\n## Introduction\nThis is Windows version of [Laravel Valet](https://github.com/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.\n\nLaravel Valet for Windows configures your PC to run [Caddy](https://caddyserver.com/) 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.\n\nIn other words, a blazing fast Laravel development environment that uses roughly les than 1mb of RAM ([see RAM usage](https://cloud.githubusercontent.com/assets/2770290/18549736/99de22fa-7b93-11e6-9bb4-adc4e641e2dd.png)).\nValet 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.\n\nPlease, keep in mind, an arbitrary php application won't work in Valet, you need to support them via special drivers. Obviously [Laravel](https://laravel.com/) is supported, as well, as many others popular php headliners, like [Symfony](https://symfony.com/), [WordPress](https://wordpress.org/), [Joomla](https://www.joomla.org/), etc. See the full list [here](#list-of-supported-applications-and-frameworks)\n\n## Important Notes\n- Set **C:\\Windows\\System32\\drivers\\etc\\hosts** file permissions to allow full control for current user/administrator \n- **_Windows 64-bit_** is supported (if anyone still needs 32-bit, please, make an issue)\n- Run **git-bash** as Administrator, as only Administrator can handle symlinks on Windows\n- 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\n\n\n## Quick How To\nThis will set up and run a new Laravel application named `blog`, accessible on localhost http://blog.dev/. Only **php** and **composer** are required to run Valet for Windows. See [advanced how to](#advanced-how-to) if you don't have them yet.\n\n**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_. \n```\ncomposer global require laravel/installer vitr/valet4windows\nmkdir ~/Sites \u0026\u0026 cd ~/Sites\nlaravel new blog\nvalet install\nvalet park\nvalet scan \nvalet start\ncd blog \u0026\u0026 valet open \n```\n## Advanced How To\n#### Install php \u0026 composer\nAs we run php with Caddy in FastCGI mode download **NTS (Non Thread Safe)** version (x86 or x64) from http://windows.php.net/download#php-7.0. Extract downloaded archive to `C:\\php`.\nCopy `php.ini-development` as `php.ini` and open it in a text editor. Uncomment extension path for Windows\n```\n ; Directory in which the loadable extensions (modules) reside.\n ; http://php.net/extension-dir\n ; extension_dir = \"./\"\n ; On windows:\n  extension_dir = \"ext\"\n```  \nuncomment required extensions, e.g.  \n```\n; Windows Extensions\n; Note that ODBC support is built in, so no dll is needed for it.\n; Note that many DLL files are located in the extensions/ (PHP 4) ext/ (PHP 5+)\n; extension folders as well as the separate PECL DLL download (PHP 5+).\n; Be sure to appropriately set the extension_dir directive.\n;\n;extension=php_bz2.dll\nextension=php_curl.dll\n;extension=php_fileinfo.dll\n;extension=php_gd2.dll\n;extension=php_gettext.dll\n;extension=php_gmp.dll\n;extension=php_intl.dll\n;extension=php_imap.dll\n;extension=php_interbase.dll\n;extension=php_ldap.dll\nextension=php_mbstring.dll\n;extension=php_exif.dll      ; Must be after mbstring as it depends on it\n;extension=php_mysqli.dll\n;extension=php_oci8_12c.dll  ; Use with Oracle Database 12c Instant Client\nextension=php_openssl.dll\n;extension=php_pdo_firebird.dll\nextension=php_pdo_mysql.dll\n;extension=php_pdo_oci.dll\nextension=php_pdo_odbc.dll\nextension=php_pdo_pgsql.dll\nextension=php_pdo_sqlite.dll\n;extension=php_pgsql.dll\n;extension=php_shmop.dll\n```\nKeep in mind Laravel's server requirement https://laravel.com/docs/master/installation#server-requirements.\n\n_**Tokenizer PHP Extension** is included by default in all Windows builds_  \nAdd php path (e.g. `C:\\php`) to your system path.\n\nInstall composer from https://getcomposer.org/download/.\nComposer-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`.\n\n#### Install Composer packages\nFrom 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. \n```\ncomposer global require laravel/installer vitr/valet4windows\n```\n#### Updating your `hosts` file\n```\nvalet scan\n```\nit updates your hosts file **C:\\Windows\\System32\\drivers\\etc\\hosts**, so,\nyou have to change its properties to allow full control for current user.\n\n#### Running Valet\nIf you're on Windows there is a chance that your ports 80 and 443 are already occupied by ISS or Skype.\nRead more how to disable ISS here http://stackoverflow.com/questions/30901434/iis-manager-in-windows-10\nand how to fix Skype here http://stackoverflow.com/questions/22994888/why-skype-using-http-or-https-ports-80-and-443  \n\n#### Open Laravel site \ncd blog \u0026\u0026 valet open \n(will open http://blog.dev in chrome)\n\n## List of supported applications and frameworks\n- [Laravel](https://laravel.com/)\n- [Symfony](https://symfony.com/) \n- [WordPress](https://wordpress.org/) \n- [Joomla](https://www.joomla.org/)\n- Bedrock\n- Cake\n- Craft\n- Jigsaw\n- Katana\n- Kirby\n- Sculpin\n- Statamic\n\n\n\n\n## Unresolved Issues\n* https://github.com/mholt/caddy/issues/732#issuecomment-207819773\nCaddy server couldn't be run as a service on Windows (means the cmd is always open), on a flip side could be easily closed)), here is more\nhttps://forum.caddyserver.com/t/requested-plugins-ideas-for-developers/127\nhttps://github.com/mholt/caddy/issues/293\nit's requested as a plugin for Caddy, hopefully they implement this soon,\nbut my workaround with an extra cmd window works just fine.\n* Rescan parked folders manually after adding new subfolder(s) (could be resolved with some sort of filesystem watcher, e.g. node.js)\n* Working with symlinks on Windows requires run git-bash as administrator\n\n## Testing\nI 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 https://ci.appveyor.com/\n\n## Roadmap\n- [ ] compile caddy with this Minimal windows service stub https://github.com/kardianos/minwinsvc\n- [ ] update valet drivers\n- [ ] demo how to install SSL certificates (so much fun:)\n- [ ] Implement the same tests as for Mac and maybe some more\n- [ ] Clean up all the OS X leftovers\n- [x] update caddyserver (Latest release  v0.9.0)\n- [x] Combine `scan` with `park, forget, link, unlink`\n- [x] Move caddy exec to bin, Caddyfile config to ~/.valet\n- [x] fix larawhale names in readme\n- [x] move the history into a standalone history file (see CHANGELOG.md)\n- [x] Port all original mac Valet commands\n    - [x] domain \n    - [x] fetch-share-url \n    - [x] forget \n    - [x] help \n    - [x] install \n    - [x] link (requires run git-bash as administrator)\n    - [x] links \n    - [x] list \n    - [x] logs \n    - [x] on-latest-version \n    - [x] open \n    - [x] park \n    - [x] paths \n    - [x] restart \n    - [x] secure, to get rid of in-browser warning you have to manually install certificate (double click on ~\\.valet\\Certificates\\blog.dev.crt and install it in the root) \n    - [x] share \n    - [x] start      \n    - [x] stop \n    - [x] uninstall \n    - [x] unlink \n    - [x] unsecure \n    - [x] which \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitr-archive%2Fvalet4windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvitr-archive%2Fvalet4windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitr-archive%2Fvalet4windows/lists"}