PHPackages jamosaur/vali - 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. [DevOps & Deployment](/categories/devops) 4. / 5. jamosaur/vali ActiveLibrary[DevOps & Deployment](/categories/devops) jamosaur/vali ============= Docker for running a Laravel application 1.3.4(2y ago)38.4kMITPHPPHP ^7.3|^8.0 Since Mar 22Pushed 2y ago2 watchersCompare [ Source](https://github.com/jamosaur/vali)[ Packagist](https://packagist.org/packages/jamosaur/vali)[ RSS](/packages/jamosaur-vali/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (3)Versions (12)Used By (0) vali ==== [](#vali) [![Latest Version on Packagist](https://camo.githubusercontent.com/864ca91bdb3fcf2162472f65c829361d5aca455f43ead65dfa487aaf31a68517/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a616d6f736175722f76616c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jamosaur/vali)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/12fb36dd90665ee3718855be9fc2ec51d16cbb8ae4acf7c877603690beaadaaa/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a616d6f736175722f76616c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jamosaur/vali) An easy way to get started with docker in your laravel installation with local https support. Heavily inspired by [Laravel Sail](https://laravel.com/docs/8.x/sail). Services included: - nginx + php8.0-fpm - mysql 8 - redis - mailhog --- Requirements ------------ [](#requirements) - docker - [mkcert](https://github.com/FiloSottile/mkcert) (if you wish to use https locally) Install ------- [](#install) Via Composer ``` $ composer require jamosaur/vali $ php artisan vali:install $ ./vendor/bin/vali up ``` The set up wizard will ask you some questions about your requirements. Answer the questions and config will be generated for you. The first time you run `up` may take a while as it will have to download docker images, subsequent runs will be much faster. Adding a bash alias ------------------- [](#adding-a-bash-alias) While not necessary, it is *highly* recommended to add a bash alias for vali. By adding an alias, you can invoke vali by `vali` instead of `./vendor/bin/vali`. To do this, add into your shell config file (~/.zshrc, ~/.bashrc) the following: ``` alias vali='./vendor/bin/vali' ``` Using HTTPS ----------- [](#using-https) To use https locally, I recommend using [mkcert](https://github.com/FiloSottile/mkcert) to generate your certificates. From your project directory, run the following: ``` vali certificates ``` vali will ask you for a domain name to use. **It will automatically create a wildcard certificate for you**. Entering `vali.test` will genereate a single certificate that works for `vali.test` and also `*.vali.test` Alternatively, if you'd like to create these manually: ``` $ mkdir certificates # We will store the certificates in this folder # For a single domain (e.g. vali.test) $ mkcert -key-file certificates/server.key -cert-file certificates/server.crt vali.test # For a wildcard $ mkcert -key-file certificates/server.key -cert-file certificates/server.crt vali.test \*.vali.test ``` Usage ----- [](#usage) **If you plan on using https locally, it is best to read through the `Using HTTPS` section above first.** Get started by running the `vali:install` artisan command. ``` php artisan vali:install ``` This will create a `docker-composer.yml` file in your project root. It will also create an `nginx-config.conf` file inside of your config folder. You can make any changes you'd like to your nginx config here. Available commands ------------------ [](#available-commands) ``` help Show this output certificates Create HTTPS certificates. up Start the containers up -d Start the containers in the background down Stop all of the running containers build Build all of the containers php Run a PHP command in the container artisan Run an artisan command. e.g. vali artisan test composer Run composer in the container migrate Migrate database mfs Refresh the database and seed test Run tests via artisan tinker Launch a tinker session in the container shell Launch a bash session in the container rootshell Launch a root bash session in the container ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 32 — LowBetter than 69% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity23 Limited adoption so far Community8 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~126 days Recently: every ~218 days Total 10 Last Release 784d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/4105611?v=4)[James Wallen-Jones](/maintainers/jamosaur)[@jamosaur](https://github.com/jamosaur) --- Top Contributors [![jamosaur](https://avatars.githubusercontent.com/u/4105611?v=4)](https://github.com/jamosaur "jamosaur (13 commits)") --- Tags laraveldocker ### Embed Badge ![Health badge](/badges/jamosaur-vali/health.svg) ``` [![Health](https://phpackages.com/badges/jamosaur-vali/health.svg)](https://phpackages.com/packages/jamosaur-vali) ``` ### Alternatives [laravel/sail Docker files for running a basic Laravel application. 1.9k199.2M1.2k](/packages/laravel-sail)[larastan/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 6.4k51.0M7.5k](/packages/larastan-larastan)[laravel/ai The official AI SDK for Laravel. 9782.1M161](/packages/laravel-ai)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 76518.2M118](/packages/laravel-mcp)[spatie/laravel-health Monitor the health of a Laravel application 87411.3M152](/packages/spatie-laravel-health)[propaganistas/laravel-disposable-email Disposable email validator 6012.9M7](/packages/propaganistas-laravel-disposable-email) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)