Skip to main content

deploy:forge

Deploy Ghostable-managed variables during a Laravel Forge deployment script.
Merges managed keys into Forge’s environment and (optionally) produces an encrypted env bundle.

Options

--encrypted
flag
Bundle non-secret variables into an encrypted file for runtime decryption. Ghostable will provision the required LARAVEL_ENV_ENCRYPTION_KEY in Forge.
--plan
flag
Print the variable names that would be deployed without changing anything.

Example

Deployment Script
if [ -f artisan ]; then
  $FORGE_PHP vendor/bin/ghostable deploy:forge --environment=production --encrypted
  $FORGE_PHP artisan config:cache
fi

deploy:vapor

Deploy Ghostable-managed variables during a Laravel Vapor build.
Can optionally ship an encrypted env file compatible with Vapor runtime decryption.

Options

--vapor-env
string
required
Target Vapor environment (e.g., production, staging). Determines which Ghostable environment to pull.
--encrypted
flag
Bundle non-secret variables into an encrypted file for runtime decryption. Ghostable injects LARAVEL_ENV_ENCRYPTION_KEY into the Vapor environment.
--plan
flag
Print the variable names that would be deployed without changing anything.

Example

vapor.yml
environments:
  production:
    build:
      - "composer install --no-dev"
      - "php vendor/bin/ghostable deploy:vapor --vapor-env=production --encrypted"

deploy:cloud

Deploy Ghostable-managed variables to Laravel Cloud during your pipeline step.
Behavior mirrors deploy:forge (merge) with optional encrypted bundle support.

Options

--encrypted
flag
Bundle non-secret variables into an encrypted file for runtime decryption. Ghostable sets the matching decryption key in Cloud.
--plan
flag
Print the variable names that would be deployed without changing anything.

Example

Deploy Script
php vendor/bin/ghostable deploy:cloud --environment=production --encrypted
php artisan config:cache

env:deploy

A generic deployment command for non-laravel specific deployments.

Options

--validate
flag
default:"true"
Require the environment pass validation.

Shared requirements

  • GHOSTABLE_CI_TOKEN must be available in the environment where the command runs (CI secrets, Forge/Cloud env, or local shell for manual runs).
Use --plan in CI to print the intended changes before applying them.
I