PHPackages vblinden/stackd - 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. [Database & ORM](/categories/database) 4. / 5. vblinden/stackd ActiveProject[Database & ORM](/categories/database) vblinden/stackd =============== Local database and service manager for macOS — MySQL, MariaDB, PostgreSQL, Valkey, Mailpit, Meilisearch, and MinIO for Laravel development v1.0.9(today)010↑2900%MITPHPPHP ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0 Since Jul 30Pushed todayCompare [ Source](https://github.com/vblinden/stackd)[ Packagist](https://packagist.org/packages/vblinden/stackd)[ Docs](https://github.com/vblinden/stackd)[ RSS](/packages/vblinden-stackd/feed)WikiDiscussions master Synced today READMEChangelog (8)Dependencies (6)Versions (11)Used By (0) stackd ====== [](#stackd) **Local database and service manager for macOS.** Create global named instances of MySQL, MariaDB, PostgreSQL, Valkey, Mailpit, Meilisearch, and MinIO — then connect any Laravel project to them. Built to sit alongside [Laravel Valet](https://laravel.com/docs/valet) without Docker. [![PHP Version](https://camo.githubusercontent.com/9cd0297cd6c1f5e83252c58d9c87589ec89dd018c4e0e91d352e634d4969b8e3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e32254532253830253933382e352d3737374242343f7374796c653d666c61742d737175617265)](https://www.php.net/)[![License](https://camo.githubusercontent.com/ac049ef4e7a0b7196b09add6ac2d4f180e544c0ac779c2b2ac2fd2723a209579/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)](LICENSE)[![Platform](https://camo.githubusercontent.com/205f65b873a4b5fec9d87c982e6544dab774c0609e323fd6a6f6b3008c544472/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f706c6174666f726d2d6d61634f532d6c69676874677265793f7374796c653d666c61742d737175617265)](#requirements) Why stackd? ----------- [](#why-stackd) - **Services** — MySQL, MariaDB, PostgreSQL, Valkey, Mailpit, Meilisearch, and MinIO - **Global instances** — one MySQL for all your apps, not a container per project - **Laravel-friendly** — `stackd env` overwrites your `.env` for every installed service (and uses your project folder as the DB name) - **No Docker required** — downloads (or builds) native binaries on demand - **macOS native** — binds to `127.0.0.1`, optional LaunchAgent start-at-login - **TablePlus & browser ready** — `stackd open` launches the right client Requirements ------------ [](#requirements) - macOS - PHP 8.2–8.5 - [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/) (Valkey / MariaDB compile) - `cmake` and OpenSSL for MariaDB (stackd can install these via Homebrew when prompted) - Avoid Homebrew MySQL/Postgres/Redis on the same ports — `stackd create` detects them and can uninstall Installation ------------ [](#installation) ### Via Composer (recommended) [](#via-composer-recommended) ``` composer global require vblinden/stackd ``` This installs the prebuilt PHAR from the package (`builds/stackd`). Make sure Composer's global `bin` directory is on your `PATH`. ### PHAR [](#phar) ``` curl -fsSL https://raw.githubusercontent.com/vblinden/stackd/master/bin/install.sh | bash ``` Or install manually: ``` curl -fsSL https://github.com/vblinden/stackd/releases/latest/download/stackd -o stackd chmod +x stackd sudo mv stackd /usr/local/bin/stackd stackd doctor ``` Default credentials ------------------- [](#default-credentials) ServiceUsernamePasswordMySQL / MariaDB`root`*(empty)*PostgreSQL`laravel`*(empty)*MinIO`stackd``secretkey`Meilisearch—random master key (shown on create)Quick start ----------- [](#quick-start) ``` # Interactive picker stackd create # Or create directly stackd create mysql stackd create valkey stackd create mailpit # From a Laravel project root — writes .env for all installed stackd services stackd env stackd env --show # print only # Open clients stackd open mysql # TablePlus stackd open mailpit # Browser # Check health stackd doctor stackd status ``` `create` starts the instance immediately and can optionally add it to start-at-login. Commands -------- [](#commands) CommandDescription`stackd create` / `add`Create (and start) a service instance`stackd start [service] [name]`Start an instance, or all instances when no service is given`stackd stop [service] [name]`Stop an instance, or all instances when no service is given`stackd restart [name]`Restart an instance`stackd status`Show all instances`stackd list`List instances as a table`stackd delete` / `remove` / `uninstall`Delete an instance and its data`stackd env [service] [name]`Write `.env` keys for installed stackd services`stackd env --show`Print variables instead of writing`stackd open [name]`Open TablePlus or the web UI`stackd logs [name]`Tail instance logs`stackd doctor`Diagnose install & dependencies`stackd autostart …`Manage LaunchAgent start-at-loginRun `stackd` with no arguments for the home screen (running services + command list). How it works ------------ [](#how-it-works) Instances live under `~/.stackd/`: ``` ~/.stackd/ ├── registry.json # Instance metadata ├── autostart.json # Start-at-login entries ├── binaries/ # Downloaded / built binaries ├── instances/ │ └── mysql/default/ │ ├── data/ │ ├── logs/ │ └── … └── logs/ ``` Binaries are fetched the first time you create a service. MariaDB and Valkey compile locally; other services use official release archives. Services are tuned for local macOS use: smaller memory footprints, less aggressive disk sync, and background process priority so idle instances are easier on battery. Restart existing instances (`stackd restart `) to pick up the new settings. Building a PHAR --------------- [](#building-a-phar) ``` composer install php stackd app:build stackd --build-version=v1.0.4 php builds/stackd --version ``` Commit `builds/stackd` before tagging. Packagist serves that PHAR via `composer global require`; tagged releases (`v*`) also attach it to the GitHub release. Contributing ------------ [](#contributing) Issues and pull requests are welcome on [GitHub](https://github.com/vblinden/stackd). License ------- [](#license) [MIT](LICENSE) ### Health Score 45 — FairBetter than 91% of packages Maintenance100 Actively maintained with recent releases Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity57 Maturing project, gaining track record 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 ~0 days Total 10 Last Release 0d ago PHP version history (2 changes)v1.0.0PHP ^8.2 v1.0.4PHP ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/c8bc88f1693a37d180d9fcbd5434d6077ce5613dce8c15d42e0ee35aeffe494e?d=identicon)[vblinden](/maintainers/vblinden) --- Top Contributors [![vblinden](https://avatars.githubusercontent.com/u/1420356?v=4)](https://github.com/vblinden "vblinden (18 commits)") --- Tags meilisearchclilaravelpharmysqlpostgresqlmariadbredisdevelopmentminiovalkeyvaletmacosmailpit ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/vblinden-stackd/health.svg) ``` [![Health](https://phpackages.com/badges/vblinden-stackd/health.svg)](https://phpackages.com/packages/vblinden-stackd) ``` ### Alternatives [scienta/doctrine-json-functions A set of extensions to Doctrine that add support for json query functions. 58925.9M55](/packages/scienta-doctrine-json-functions)[ramadan/custom-fresh A Laravel package to specify the tables that you do not want to drop while refreshing the database. 611.6k](/packages/ramadan-custom-fresh)[watheqalshowaiter/model-fields Get model fields fast — required, nullable, or default 402.1k](/packages/watheqalshowaiter-model-fields)[moharrum/laravel-adminer Adminer database management tool for your Laravel application. 451.0k](/packages/moharrum-laravel-adminer)[ramadan/easy-model A Laravel package for enjoyably managing database queries. 111.6k](/packages/ramadan-easy-model)[vitalibr/laravel5-exporter MySQL Workbench Schema Exporter for Laravel 5.0 161.0k](/packages/vitalibr-laravel5-exporter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)