{"id":13448678,"url":"https://github.com/cretueusebiu/valet-windows","last_synced_at":"2025-12-30T04:34:14.959Z","repository":{"id":37242307,"uuid":"58159971","full_name":"cretueusebiu/valet-windows","owner":"cretueusebiu","description":"Laravel Valet for Windows.","archived":false,"fork":true,"pushed_at":"2025-03-01T06:25:15.000Z","size":77438,"stargazers_count":913,"open_issues_count":17,"forks_count":88,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-03-20T05:35:24.804Z","etag":null,"topics":["dev-tool","php","windows"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"laravel/valet","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cretueusebiu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-05T20:53:36.000Z","updated_at":"2025-03-17T17:02:10.000Z","dependencies_parsed_at":"2023-02-01T00:15:33.756Z","dependency_job_id":null,"html_url":"https://github.com/cretueusebiu/valet-windows","commit_stats":null,"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cretueusebiu%2Fvalet-windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cretueusebiu%2Fvalet-windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cretueusebiu%2Fvalet-windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cretueusebiu%2Fvalet-windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cretueusebiu","download_url":"https://codeload.github.com/cretueusebiu/valet-windows/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244937751,"owners_count":20535124,"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":["dev-tool","php","windows"],"created_at":"2024-07-31T05:01:52.464Z","updated_at":"2025-12-13T00:08:50.111Z","avatar_url":"https://github.com/cretueusebiu.png","language":"PHP","funding_links":[],"categories":["Vim script","Resources"],"sub_categories":["Development Tools"],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://laravel.com/assets/img/components/logo-valet.svg\"\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/cretueusebiu/valet-windows/actions?query=workflow%3Atests\"\u003e\u003cimg src=\"https://github.com/cretueusebiu/valet-windows/workflows/Tests/badge.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/cretueusebiu/valet-windows\"\u003e\u003cimg src=\"https://poser.pugx.org/cretueusebiu/valet-windows/d/total.svg\" alt=\"Total Downloads\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/cretueusebiu/valet-windows\"\u003e\u003cimg src=\"https://poser.pugx.org/cretueusebiu/valet-windows/v/stable.svg\" alt=\"Latest Stable Version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/cretueusebiu/valet-windows\"\u003e\u003cimg src=\"https://poser.pugx.org/cretueusebiu/valet-windows/license.svg\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eWindows port of the popular development environment \u003ca href=\"https://github.com/laravel/valet\"\u003eLaravel Valet\u003c/a\u003e.\u003c/p\u003e\n\n## Introduction\n\nValet is a Laravel development environment for Windows. No Vagrant, no `/etc/hosts` file. You can even share your sites publicly using local tunnels. _Yeah, we like it too._\n\nLaravel Valet configures your Windows to always run Nginx in the background when your machine starts. Then, using [Acrylic DNS](http://mayakron.altervista.org/wikibase/show.php?id=AcrylicHome), Valet proxies all requests on the `*.test` domain to point to sites installed on your local machine.\n\n## Documentation\n\nBefore installation, make sure that no other programs such as Apache or Nginx are binding to your local machine's port 80. \u003cbr\u003e Also make sure to open your preferred terminal (Windows Terminal, CMD, Git Bash, PowerShell, etc.) as Administrator. \n\n- If you don't have PHP installed, open PowerShell (3.0+) as Administrator and run: \n\n```bash\nSet-ExecutionPolicy RemoteSigned -Scope Process; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri \"https://github.com/cretueusebiu/valet-windows/raw/master/bin/php.ps1\" -OutFile $env:temp\\php.ps1; .$env:temp\\php.ps1 \"8.3\"\n```\n\n(You can replace `8.3` with the PHP version you want to install: `7.4`, `8.0`, `8.1`, `8.2`, `8.3`)\n\n\u003e This script will download and install PHP for you and add it to your environment path variable. PowerShell is only required for this step.\n\n- If you don't have Composer installed, make sure to [install](https://getcomposer.org/Composer-Setup.exe) it.\n\n- Install Valet with Composer via `composer global require cretueusebiu/valet-windows`.\n\n- Run the `valet install` command. This will configure and install Valet and register Valet's daemon to launch when your system starts.\n\n- If you're installing on Windows 10/11, you may need to [manually configure](https://mayakron.altervista.org/support/acrylic/Windows10Configuration.htm) Windows to use the Acrylic DNS proxy.\n\nValet will automatically start its daemon each time your machine boots. There is no need to run `valet start` or `valet install` ever again once the initial Valet installation is complete.\n\nFor more please refer to the official documentation on the [Laravel website](https://laravel.com/docs/8.x/valet#serving-sites).\n\n## Known Issues\n\n- WSL2 distros fail because of Acrylic DNS Proxy ([microsoft/wsl#4929](https://github.com/microsoft/WSL/issues/4929)). Use `valet stop`, start WSL2 then `valet start`.\n- The PHP-CGI process uses port 9001. If it's already used change it in `~/.config/valet/config.json` and run `valet install` again.\n- When sharing sites the url will not be copied to the clipboard.\n- You must run the `valet` commands from the drive where Valet is installed, except for park and link. See [#12](https://github.com/cretueusebiu/valet-windows/issues/12#issuecomment-283111834).\n- If your machine is not connected to the internet you'll have to manually add the domains in your `hosts` file or you can install the [Microsoft Loopback Adapter](https://docs.microsoft.com/en-us/troubleshoot/windows-server/networking/install-microsoft-loopback-adapter) as this simulates an active local network interface that Valet can bind too.\n\n## Xdebug \n\nTo enable a debugging session you can use [Xdebug helper](https://chrome.google.com/webstore/detail/xdebug-helper/eadndfjplgieldjbigjakmdgkmoaaaoc) or set a cookie with the name `XDEBUG_SESSION`.\n\n## Testing\n\nRun the unit tests with:\n\n```bash\ncomposer test-unit\n```\n\nBefore running the integration tests for the first time, you must build the Docker container with:\n\n```bash\ncomposer build-docker\n```\n\nNext, you can run the integration tests with:\n\n```bash\ncomposer test-integration\n```\n\n## Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.\n\n## License\n\nLaravel Valet is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcretueusebiu%2Fvalet-windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcretueusebiu%2Fvalet-windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcretueusebiu%2Fvalet-windows/lists"}