README

https://deployerphp.com

Meet DeployerPHP

This is DeployerPHP, a complete set of CLI tools for provisioning, installing, and deploying servers and sites using PHP. It serves as an open-source alternative to services such as Ploi, RunCloud or Laravel Forge.

Here it is in action:

• Crash Course
• Benefits
  • Unlimited Servers & Sites
  • No Vendor Lock-In
  • End-To-End Management
  • Composable Commands
  • AI Automation
• License
• Contributing

Crash Course

Here's a quick but complete run-through to start deploying immediately. Run each of these commands in sequence to go from zero to deploy:

# Install DeployerPHP
composer require --dev loadinglucian/deployer-php
alias deployer="./vendor/bin/deployer"

# Add your server to the inventory
deployer server:add

# Alternatively, set up a cloud instance and add it to
# the inventory automatically with a single command:
#
# $> deployer aws:provision
# $> deployer do:provision

# Install Nginx, PHP, Bun and generate a deploy key
deployer server:install

# Optionally, install your preferred database service:
#
# $> deployer mariadb:install
# $> deployer postgresql:install
# $> deployer redis:install
# $> deployer memcached:install

# Create a site
deployer site:create

# Optionally, create deployment scripts and upload shared files:
#
# $> deployer scaffold:scripts
# $> deployer site:shared:push

# Deploy your application
deployer site:deploy

# Enable HTTPS
deployer site:https

Benefits

Unlimited Servers & Sites

There aren't any limits or restrictions on how many servers and sites you can deploy or manage: provision, install, manage, and deploy as many as you want.

No Vendor Lock-In

You can manage servers and deploy sites with any hosting or cloud provider. If your server runs Ubuntu LTS and you can SSH into it, you can manage it with DeployerPHP.

End-To-End Management

With DeployerPHP, you can effortlessly provision cloud instances, install services, and manage deployments and operations directly from the command line.

Composable Commands

Atomic commands allow you to easily spin up new servers and create automation pipelines for running your own custom workflows on demand.

AI Agent Support

Use your favorite AI agents to debug server and site issues, using DeployerPHP's built-in agent skills scaffolding.

License

DeployerPHP is open-source software distributed under the MIT License.

You can use it freely for personal or commercial projects, without any restrictions.

This also means there are no guarantees or warranties. You are on your own.

Contributing

Thank you for considering contributing to DeployerPHP!

Please see CONTRIBUTING for details.