PHPackages reyemtech/sail - 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. reyemtech/sail ActiveLibrary[DevOps & Deployment](/categories/devops) reyemtech/sail ============== Docker files for running a basic Laravel application. v3.4.1(1w ago)01.2kMITPHPPHP ^8.0CI passing Since May 1Pushed 1w agoCompare [ Source](https://github.com/ReyemTech/sail)[ Packagist](https://packagist.org/packages/reyemtech/sail)[ RSS](/packages/reyemtech-sail/feed)WikiDiscussions 1.x Synced 3d ago READMEChangelog (10)Dependencies (32)Versions (69)Used By (0) ![ReyemTech](/art/reyemtech-logo-light.png) [![Laravel Sail](/art/logo.svg)](/art/logo.svg) [![Total Downloads](https://camo.githubusercontent.com/26384f2f869559891bc8403782a6c9c79e962cf1c21a51e59f64fe2397fff00c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726579656d746563682f7361696c)](https://packagist.org/packages/reyemtech/sail)[![Latest Stable Version](https://camo.githubusercontent.com/3e5ed5534cd5b63989c42ecb924eb52ef6c65aa89e323c38b73d452514514665/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726579656d746563682f7361696c)](https://packagist.org/packages/reyemtech/sail)[![License](https://camo.githubusercontent.com/7d5f885e40800d8483d937710b064b7dc12a2d11dc449e7f59da110259b15c8e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f726579656d746563682f7361696c)](https://packagist.org/packages/reyemtech/sail) Introduction ------------ [](#introduction) **ReyemTech Sail** is a fork of [Laravel Sail](https://github.com/laravel/sail) that keeps everything you already use for local development — the `sail` CLI, the `docker-compose` services, the PHP runtimes — and extends it into a **build-and-ship toolchain** for getting a Laravel app from your laptop into a Kubernetes cluster. Where upstream Sail stops at local Docker, this fork adds: - **Multi-architecture image builds** (`linux/amd64` + `linux/arm64`) driven by Docker Bake, with optimized multi-stage production targets (cli/fpm). - **Helm chart generation** — `sail:build` and `sail:helm` emit a complete, opinionated chart (web/worker/scheduler tiers, HPA, PDBs, ingress, external secrets, pre-sync migration jobs) straight from your project. - **Multi-registry push with auto-authentication** — GHCR, Docker Hub, GitLab, Quay, Harbor, AWS ECR, and Azure ACR. - **CI/CD pipeline generation** — one command emits a ready-to-run pipeline for GitHub Actions, GitLab CI, Azure DevOps, CircleCI, AWS CodeBuild, or Travis. - **Non-interactive build flags** so the same commands work in CI as on your machine. - **Production extras baked into the chart and runtime:** Redis Sentinel-aware PHP client, Typesense subchart, and a Laravel Nightwatch agent sidecar. It is a **drop-in replacement** for `laravel/sail` — it uses the same `Laravel\Sail` namespace and conflicts with the upstream package, so install one or the other. > **Relationship to upstream:** this fork periodically merges `laravel/sail` so the local-dev experience stays current. Everything in the [Laravel Sail documentation](https://laravel.com/docs/sail) applies here too; this README focuses on what the fork adds on top. Quickstart ---------- [](#quickstart) From an empty `composer require` to a production image and Helm chart in four steps. **1. Install into your Laravel app** New Laravel apps ship with `laravel/sail` in `require-dev`. Remove it first — this fork uses the same `Laravel\Sail` namespace and **will collide** with the upstream package: ``` composer remove laravel/sail # required: new Laravel apps include it by default composer require reyemtech/sail --dev php artisan sail:install --php=8.4 # or --php=8.5 php artisan sail:publish # publish Docker runtimes, bin scripts, configs ``` **2. Develop locally** ``` ./vendor/bin/sail up -d # start the stack ./vendor/bin/sail artisan migrate # run migrations # app is now on http://localhost ``` Tip: install the [global `sail` wrapper](#multi-project-sail-wrapper) once and just run `sail up -d` from any project. **3. Build a production image + Helm chart** ``` php artisan sail:build \ --environments=production \ --architectures=linux/amd64,linux/arm64 \ --repository=ghcr.io \ --organization=acme \ --domains=app.example.com \ --push \ --bump=patch ``` This builds multi-arch images, pushes them to your registry (authenticating automatically), and generates a deployable Helm chart under `helm/`. See [Building images + Helm charts](#building-images--helm-charts) for every flag. **4. Wire up CI (optional)** ``` php artisan sail:ci --provider=github-actions ``` Emits a pipeline that runs the same build on every push and tag. See [CI/CD generation](#cicd-generation) for the other providers. Commands -------- [](#commands) CommandPurpose`sail:install`Initial project setup — `docker-compose.yml`, `.env`, PHPUnit config`sail:add`Add services to an existing installation`sail:publish`Publish Docker runtimes, `bin` scripts, and database configs`sail:build`Build multi-arch Docker images (optionally push) **and** generate the Helm chart`sail:helm`Regenerate the Helm chart only, merging new keys from `values.stub``sail:helm:validate`Validate generated charts via `helm lint``sail:ci`Generate a CI/CD pipeline (GitHub Actions, GitLab, Azure, CircleCI, CodeBuild, Travis)Multi-project `sail` wrapper ---------------------------- [](#multi-project-sail-wrapper) The fork ships a `sail-wrapper` that resolves and runs the **nearest** project's `vendor/bin/sail`, so a single global `sail` works across every project on your machine. It is installed automatically to `~/.local/bin/sail` (or `~/bin`) on `composer install`/`update`. Run it from anywhere: ``` cd /path/to/project-a && sail up -d # uses project-a's Sail cd /path/to/project-b && sail artisan migrate # uses project-b's Sail ``` Manual install, if the automatic step is skipped: ``` cp vendor/reyemtech/sail/bin/sail-wrapper ~/.local/bin/sail chmod +x ~/.local/bin/sail ``` Make sure the target directory is on your `PATH`: ``` export PATH="$HOME/.local/bin:$PATH" # add to ~/.bashrc or ~/.zshrc ``` Building images + Helm charts ----------------------------- [](#building-images--helm-charts) `sail:build` builds multi-arch images via Docker Bake and generates the Helm chart in one step: ``` php artisan sail:build \ --environments=production \ --architectures=linux/amd64,linux/arm64 \ --repository=ghcr.io \ --organization=acme \ --domains=app.example.com \ --build-version=1.2.3 \ --push \ --use-previous \ --bump=patch ``` Key flags: - `--use-previous` — reuse the last saved build config without prompting (ideal for CI) - `--bump=patch|minor|major|no` — bump the version non-interactively - `--repository=none` — local-only build (disables push) - `--remove-vendor-node-modules` / `--keep-vendor-node-modules` — strip or keep `vendor/` and `node_modules/` in the final image (stripped by default) Validation rules: - Environments must be within `local, production` - Architectures must be in the package's allowed list - Repository must be a known registry shorthand, `none`, or a full registry URL (e.g. `888657980245.dkr.ecr.us-east-1.amazonaws.com`) ### Registry support [](#registry-support) `sail:build` authenticates against the target registry automatically, prompting only if you are not already logged in. **Standard registries** — GitHub Container Registry (`ghcr.io`), Docker Hub (`docker.io`), GitLab (`registry.gitlab.com`), Quay (`quay.io`), Harbor, and any custom registry URL. **AWS ECR:** ``` php artisan sail:build --repository=888657980245.dkr.ecr.us-east-1.amazonaws.com --push php artisan sail:build --repository=ecr --push # shorthand # Requires: AWS CLI configured (aws configure). Optional: AWS_REGION, AWS_ACCOUNT_ID ``` **Azure ACR:** ``` php artisan sail:build --repository=myregistry.azurecr.io --push php artisan sail:build --repository=azurecr --push # shorthand # Requires: Azure CLI logged in (az login). Optional: AZURE_ACR_NAME ``` Helm ---- [](#helm) ### Regenerate the chart [](#regenerate-the-chart) Regenerate the Helm chart without rebuilding images: ``` php artisan sail:helm # current version php artisan sail:helm --chart-version=1.2.3 # specific version php artisan sail:helm --bump=patch # bump and regenerate php artisan sail:helm --no-version-update # skip Chart.yaml version bump ``` This refreshes templates from the stubs, **merges new keys from `values.stub` into your existing `values.yaml`** (without clobbering your overrides), updates `Chart.yaml`, and runs `helm lint`. ### Validate [](#validate) ``` php artisan sail:helm:validate ``` ### What the chart includes [](#what-the-chart-includes) - **Tiers:** `web`, `worker`, and `scheduler` deployments, each independently configurable. - **Autoscaling:** HPA enabled by default for the web tier, configurable per tier. - **High availability:** configurable Pod Disruption Budgets. - **ServiceAccounts:** optional creation with annotations. - **External Secrets:** automatic API-version detection (`v1`/`v1beta1`). - **Pre-sync jobs:** ArgoCD pre-sync hooks for image existence checks and database migrations. - **Scheduler vendor PVC:** enabled by default (`scheduler.vendorPvc.*`), 5Gi, storage class `sata`. - **Probes:** web readiness/liveness on `/up`. - **Security defaults:** non-root `securityContext`, `fsGroup` 1000, resource requests/limits set in `values.stub`. - **Typesense subchart** and **Laravel Nightwatch agent sidecar** support. Stubs live in `stubs/helm`. User-owned overrides belong in `values.production.yaml`, which is never overwritten by regeneration. ### Rollback [](#rollback) ``` helm history helm rollback ``` Redis Sentinel -------------- [](#redis-sentinel) The fork ships a Sentinel-aware phpredis client (`src/Redis/`) that discovers the current master through Sentinel and retries reconnects with backoff. Wire it up through the Helm chart's Redis Sentinel env vars, or use the connector directly in your Redis config. Docker runtimes --------------- [](#docker-runtimes) - PHP runtimes live in `runtimes/` as Docker Bake files: `runtimes/8.x` is parameterized via `PHP_VERSION` (default `8.4`) and `runtimes/8.5` reuses the same bake structure pinned to `PHP_VERSION=8.5`. - Multi-stage targets: `base`, `app`, and `production` (cli/fpm). CI/CD generation ---------------- [](#cicd-generation) Generate a pipeline that builds images and Helm charts for your provider: ``` php artisan sail:ci # interactive php artisan sail:ci --provider=github-actions php artisan sail:ci --provider=gitlab-ci php artisan sail:ci --provider=azure-devops php artisan sail:ci --provider=circleci php artisan sail:ci --provider=aws-codebuild php artisan sail:ci --provider=travis php artisan sail:ci --provider=github-actions --overwrite ``` ProviderOutputGitHub Actions`.github/workflows/build.yml`GitLab CI/CD`.gitlab-ci.yml`Azure DevOps`azure-pipelines/build.yml`CircleCI`.circleci/config.yml`AWS CodeBuild`buildspec.yml`Travis CI`.travis.yml`Every generated pipeline: - Builds on push to `main`/`master` and on version tags (`v*`) - Supports multi-architecture builds (amd64, arm64) - Authenticates against the target registry (ECR, ACR, standard) - Produces both Docker images and Helm charts - Derives the version from git tags, falling back to a date-based version ### Required secrets / variables [](#required-secrets--variables) ProviderConfigurationGitHub Actions`REGISTRY_USERNAME`, `REGISTRY_PASSWORD` (or `GHCR_IO_USERNAME`/`GHCR_IO_PASSWORD`); ECR: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`; ACR: `AZURE_CREDENTIALS`GitLab CI`REGISTRY_USERNAME`, `REGISTRY_PASSWORD` (or `CI_REGISTRY_USER`/`CI_REGISTRY_PASSWORD`); ECR: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`; ACR: `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_TENANT_ID`Azure DevOps`REGISTRY_USERNAME`, `REGISTRY_PASSWORD`; service connections for ACR and AWSCircleCI`REGISTRY_USERNAME`, `REGISTRY_PASSWORD`; ECR: `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`AWS CodeBuild`REGISTRY_USERNAME`, `REGISTRY_PASSWORD`; IAM role for ECR (no static credentials)Travis CI`REGISTRY_USERNAME`, `REGISTRY_PASSWORD`Development ----------- [](#development) ``` composer test # full suite (Orchestra Testbench) composer test:feature composer test:integration vendor/bin/phpstan analyse src # static analysis (PHPStan level 0) ``` Credits ------- [](#credits) Built on [Laravel Sail](https://github.com/laravel/sail) by Taylor Otwell and the Laravel community. ReyemTech Sail tracks upstream and layers the build/deploy tooling described above on top. Contributing & Security --------------------------- [](#contributing--security) - Issues: - Upstream Sail security policy: - License: [MIT](LICENSE.md) ### Health Score 50 — FairBetter than 95% of packages Maintenance98 Actively maintained with recent releases Popularity19 Limited adoption so far Community19 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 ~7 days Recently: every ~13 days Total 62 Last Release 10d ago Major Versions 1.52.12 → v2.0.02026-03-17 v2.1.0 → v3.0.02026-04-17 ### Community Maintainers ![](https://www.gravatar.com/avatar/79399147ddc617e3c70a84cfc7ebfc49b99488f4c1743b83ae61890bf6410e11?d=identicon)[mariomeyer](/maintainers/mariomeyer) --- Top Contributors [![driesvints](https://avatars.githubusercontent.com/u/594614?v=4)](https://github.com/driesvints "driesvints (187 commits)")[![mariomeyer](https://avatars.githubusercontent.com/u/867650?v=4)](https://github.com/mariomeyer "mariomeyer (140 commits)")[![taylorotwell](https://avatars.githubusercontent.com/u/463230?v=4)](https://github.com/taylorotwell "taylorotwell (113 commits)")[![Jubeki](https://avatars.githubusercontent.com/u/15707543?v=4)](https://github.com/Jubeki "Jubeki (21 commits)")[![finagin](https://avatars.githubusercontent.com/u/11045296?v=4)](https://github.com/finagin "finagin (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (11 commits)")[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (7 commits)")[![jessarcher](https://avatars.githubusercontent.com/u/4977161?v=4)](https://github.com/jessarcher "jessarcher (7 commits)")[![pushpak1300](https://avatars.githubusercontent.com/u/31663512?v=4)](https://github.com/pushpak1300 "pushpak1300 (5 commits)")[![abdounikarim](https://avatars.githubusercontent.com/u/15892761?v=4)](https://github.com/abdounikarim "abdounikarim (4 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (4 commits)")[![SamuelMwangiW](https://avatars.githubusercontent.com/u/1807304?v=4)](https://github.com/SamuelMwangiW "SamuelMwangiW (4 commits)")[![sweptsquash](https://avatars.githubusercontent.com/u/9886472?v=4)](https://github.com/sweptsquash "sweptsquash (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![kiani01lab](https://avatars.githubusercontent.com/u/185515145?v=4)](https://github.com/kiani01lab "kiani01lab (3 commits)")[![ariaieboy](https://avatars.githubusercontent.com/u/15873972?v=4)](https://github.com/ariaieboy "ariaieboy (3 commits)")[![prageeth](https://avatars.githubusercontent.com/u/230793?v=4)](https://github.com/prageeth "prageeth (3 commits)")[![ankurk91](https://avatars.githubusercontent.com/u/6111524?v=4)](https://github.com/ankurk91 "ankurk91 (3 commits)")[![ribeirobreno](https://avatars.githubusercontent.com/u/1036515?v=4)](https://github.com/ribeirobreno "ribeirobreno (3 commits)")[![amayer5125](https://avatars.githubusercontent.com/u/3212673?v=4)](https://github.com/amayer5125 "amayer5125 (3 commits)") --- Tags laraveldocker ### Code Quality Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/reyemtech-sail/health.svg) ``` [![Health](https://phpackages.com/badges/reyemtech-sail/health.svg)](https://phpackages.com/packages/reyemtech-sail) ``` ### Alternatives [laravel/sail Docker files for running a basic Laravel application. 1.9k205.7M1.3k](/packages/laravel-sail)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[laravel/horizon Dashboard and code-driven configuration for Laravel queues. 4.2k95.4M307](/packages/laravel-horizon)[laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.6k29.9M148](/packages/laravel-cashier)[laravel/ai The official AI SDK for Laravel. 1.0k3.2M201](/packages/laravel-ai)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k15.1M132](/packages/laravel-pulse) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)