README

Introduction

This fork of Laravel Sail adds:

• Helm chart generation (with scheduler vendor PVC support)
• Non-interactive sail:build flags (--use-previous, --bump, etc.)
• Laravel Boost guideline for IDE/AI context
• Multi-stage Docker builds (bake) shared across PHP versions (8.x/8.5)

Quick start

composer require reyemtech/sail --dev php artisan sail:install --php=8.4 # or 8.5 php artisan sail:publish

Multi-project support

This fork includes a sail-wrapper that automatically finds and runs the nearest project's Sail script. This allows you to use sail from any directory when working with multiple Sail projects on the same machine.

Automatic installation: The wrapper is automatically installed to ~/.local/bin/sail (or ~/bin if available) when you install or update the package via Composer.

Usage: Simply run sail from any directory, and it will automatically find and execute the nearest project's vendor/bin/sail:

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 installation: If automatic installation fails, you can manually install:

cp vendor/reyemtech/sail/bin/sail-wrapper ~/.local/bin/sail chmod +x ~/.local/bin/sail

Note: Make sure ~/.local/bin (or ~/bin) is in your PATH. Add to your ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Build with bake + Helm

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 config without prompts
• --bump=patch|minor|major|no: bump version non-interactively
• --repository=none: local-only build (disables push)
• --remove-vendor-node-modules: Remove vendor/ and node_modules/ from final image (default: true)
• --keep-vendor-node-modules: Keep vendor/ and node_modules/ in final image

Validation:

• Environments must be in local, production
• Architectures must be in the allowed list from the package
• Repository must be one of the known registries, none, or a full registry URL (e.g., 888657980245.dkr.ecr.us-east-1.amazonaws.com)

Registry Support

The build command supports multiple container registries with automatic authentication:

Standard Registries:

• GitHub Container Registry (ghcr.io)
• Docker Hub (docker.io)
• GitLab Container Registry (registry.gitlab.com)
• Quay.io (quay.io)
• Custom registries (any valid registry URL)

AWS ECR:

php artisan sail:build --repository=888657980245.dkr.ecr.us-east-1.amazonaws.com --push # Or use shorthand: php artisan sail:build --repository=ecr --push # Requires: AWS CLI configured (aws configure) # Environment variables: AWS_REGION, AWS_ACCOUNT_ID (optional)

Azure ACR:

php artisan sail:build --repository=myregistry.azurecr.io --push # Or use shorthand: php artisan sail:build --repository=azurecr --push # Requires: Azure CLI installed and logged in (az login) # Environment variable: AZURE_ACR_NAME (optional)

The build command will automatically check if you're logged in and prompt for authentication if needed.

Helm Commands

Regenerate Helm Chart

Regenerate the Helm chart without building Docker images:

# Regenerate with current version php artisan sail:helm # Regenerate with specific version php artisan sail:helm --chart-version=1.2.3 # Bump version and regenerate php artisan sail:helm --bump=patch # Skip version update in Chart.yaml php artisan sail:helm --no-version-update

This command:

• Updates Helm templates from stubs
• Merges new configuration variables from values.stub into existing values.yaml
• Updates Chart.yaml version (unless --no-version-update is used)
• Validates the chart using helm lint

Useful when you need to update templates or add new configuration options without rebuilding Docker images.

Helm Chart Notes

• Stubs live in stubs/helm
• Scheduler vendor PVC: enabled by default (scheduler.vendorPvc.*), default size 5Gi, storage class sata
• Resources & security defaults:
  • resources requests/limits set in values.stub
  • securityContext defaults to non-root, fsGroup 1000
• Probes: web gets readiness/liveness on /up
• Autoscaling: HPA enabled by default for web tier, configurable per tier
• Pod Disruption Budgets: Configurable PDBs for high availability
• ServiceAccounts: Optional ServiceAccount creation with annotations
• External Secrets: Automatic API version detection (v1 or v1beta1)

Docker runtime

• PHP 8.x bake files reside in runtimes/8.x
• PHP 8.5 reuses the 8.x bake structure (runtimes/8.5/docker-bake.hcl targets 8.x, PHP_VERSION=8.5)
• Multi-stage targets: base, app, production (cli/fpm)

CI/CD Integration

Generate CI/CD configuration files for automated Docker builds:

# Interactive selection php artisan sail:ci # Direct selection 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 # Overwrite existing configuration php artisan sail:ci --provider=github-actions --overwrite

Supported CI Platforms

1. GitHub Actions - .github/workflows/build.yml
2. GitLab CI/CD - .gitlab-ci.yml
3. Azure DevOps Pipelines - azure-pipelines/build.yml
4. CircleCI - .circleci/config.yml
5. AWS CodeBuild - buildspec.yml
6. Travis CI - .travis.yml

All CI configurations:

• Build on push to main/master branches
• Build on version tags (v*)
• Support multi-architecture builds (amd64, arm64)
• Include registry authentication (ECR, ACR, standard)
• Generate both Docker images and Helm charts
• Extract version from git tags or generate date-based versions

CI Setup Requirements

GitHub Actions:

• Secrets: REGISTRY_USERNAME, REGISTRY_PASSWORD (or GHCR_IO_USERNAME, GHCR_IO_PASSWORD)
• For ECR: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION
• For ACR: AZURE_CREDENTIALS

GitLab CI:

• CI/CD Variables: REGISTRY_USERNAME, REGISTRY_PASSWORD (or CI_REGISTRY_USER, CI_REGISTRY_PASSWORD)
• For ECR: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION
• For ACR: AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID

Azure DevOps:

• Variables: REGISTRY_USERNAME, REGISTRY_PASSWORD
• Service connections for ACR and AWS

CircleCI:

• Environment Variables: REGISTRY_USERNAME, REGISTRY_PASSWORD
• For ECR: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION

AWS CodeBuild:

• Environment Variables: REGISTRY_USERNAME, REGISTRY_PASSWORD
• IAM role for ECR authentication (no credentials needed)

Travis CI:

• Environment Variables: REGISTRY_USERNAME, REGISTRY_PASSWORD

Rollback (Helm)

helm rollback <release> <revision> helm history <release>

Contributing / Security

• Issues: https://github.com/reyemtech/sail/issues
• Security: https://github.com/laravel/sail/security/policy
• License: MIT