Deploy your application to any server with ease.
This Laravel package allows you to easily deploy your application to any server you have SSH access to. While it'll work for pretty much any type of server, it's optimized for Nucleus managed servers. We take care of the hosting & uptime, you can focus on the application.
You can use this package to deploy on your own servers, Forge servers, ... you name it.
In your application, install the package as such:
composer require nucleus/laravel-deploy
Next, publish the package's content.
php artisan vendor:publish --provider=Nucleus\\Deploy\\DeployServiceProvider
After the install, the package installs a new
artisan command to allow you to quickly deploy.
php artisan deploy
It reads your
.env file for more information about where to deploy to.
.env will need the following required parameters.
DEPLOY_HOST= DEPLOY_USER= DEPLOY_DIR_BASE= DEPLOY_REPOSITORY=
These configurations will be provided to you by our support team, but they're pretty easy to complete yourself, too.
On top of the above, there are the following optional parameters that allow you to finetune the deployment to your liking.
DEPLOY_SSH_PORT=22 DEPLOY_DIR_RELEASES=releases DEPLOY_DIR_PERSISTENT=persistent DEPLOY_CURRENT=current DEPLOY_BRANCH=master DEPLOY_SLACK_WEBHOOK= DEPLOY_SLACK_CHANNEL= DEPLOY_SLACK_MESSAGE= DEPLOY_HIPCHAT_WEBHOOK= DEPLOY_HIPCHAT_ROOM= DEPLOY_HIPCHAT_FROM= DEPLOY_HIPCHAT_COLOR= DEPLOY_HIPCHAT_MESSAGE=
These can be completed to your liking, to finetune the deployment process.
Slack notifications configuration
DEPLOY_SLACK_WEBHOOK is the entire webhook URL.
DEPLOY_SLACK_CHANNEL is a
#channel or a
@user that will recieve the notification. Both are required to use Slack notifications.
DEPLOY_SLACK_MESSAGE you can customise the message that will be returned in Slack. If left empty, the message will be the one generated by Envoy.
DEPLOY_HIPCHAT_WEBHOOK is the entire webhook URL.
DEPLOY_HIPCHAT_ROOM is the
room that will recieve the notification,
DEPLOY_HIPCHAT_FROM is a label to be shown in addition to the sender's name. These variable are required to use HipChat notification.
DEPLOY_HIPCHAT_MESSAGE you can customise the message that will be returned in Slack. If left empty, the message will be the one generated by Envoy.
DEPLOY_HIPCHAT_COLOR is the background color for message, default is purple.