PHPackages                             guysolamour/laravel-deploy - 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. guysolamour/laravel-deploy

ActiveLibrary[DevOps & Deployment](/categories/devops)

guysolamour/laravel-deploy
==========================

Laravel deployment system built with ansible & ansistrano

v1.3(2y ago)048MITShell

Since Jun 13Pushed 2y ago1 watchersCompare

[ Source](https://github.com/guysolamour/laravel-deploy)[ Packagist](https://packagist.org/packages/guysolamour/laravel-deploy)[ RSS](/packages/guysolamour-laravel-deploy/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

Laravel Administrable Deploy
============================

[](#laravel-administrable-deploy)

[![Packagist](https://camo.githubusercontent.com/0fb0577e3d0c64c3ed838e68ad9c4e3377516419f22f0149e229cedcc169ac57/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f677579736f6c616d6f75722f6c61726176656c2d61646d696e6973747261626c652d6465706c6f792e737667)](https://packagist.org/packages/guysolamour/laravel-administrable-deploy)[![Packagist](https://camo.githubusercontent.com/ab9f924ff328f681d449e5e0daf4a9ea961e0eff19593481654e10be9aa7242a/68747470733a2f2f706f7365722e707567782e6f72672f677579736f6c616d6f75722f6c61726176656c2d61646d696e6973747261626c652d6465706c6f792f642f746f74616c2e737667)](https://packagist.org/packages/guysolamour/laravel-administrable-deploy)[![Packagist](https://camo.githubusercontent.com/2fd211ffe9af5c4bcad0b081797a991c9267c4653c61a57c51cdf9f71966326b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f677579736f6c616d6f75722f6c61726176656c2d61646d696e6973747261626c652d6465706c6f792e737667)](https://packagist.org/packages/guysolamour/laravel-administrable-deploy)

This package allows you to deploy a website on a dedicated server or a VPS by installing the various tools necessary for the operation of the site and by automating the deployment process.

---

### Prerequis

[](#prerequis)

1. Works on Unix type system (MacOs and Linux)
2. Ubuntu Server operating system
3. have a bash version >= 4 (you can do `bash --version `) otherwise update the bash shell
4. Instal ansible ([https://docs.ansible.com/ansible/latest/installation\_guide/intro\_installation.html](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html))
5. Instal anistrano ()

### Installation

[](#installation)

Install via composer

```
composer require guysolamour/laravel-deploy
```

### Preparing the server

[](#preparing-the-server)

1- Connect to the server

```
ssh root@000.000.000.000
# 000.000.000.000 must be changed with your server ip address
```

2- Create a user to run the tasks

```
sudo useradd user -s /bin/bash -d /home/user -m -G sudo
# user must be changed with your own user
```

3- Add created user to sudoers file

```
sudo visudo
# Append user ALL=(ALL) NOPASSWD:ALL at the end of line
# user must be changed with your own user
```

4- Install python on the remote server

```
sudo apt install -y python-apt
```

5- Disconnect from the remote machine and copy host machine ssh key for the created user

```
ssh-copy-id -i ~/.ssh/id_rsa.pub user@000.000.000.000
# If you dont have generate ssh key before use sshkeygen command to generate newly key
# 000.000.000.000 must be changed with your server ip address
```

### Scaffold

[](#scaffold)

Run the scaffold command to generate the necessary base files. This command must be executed once and at the very beginning.

```
./vendor/bin/deploy scaffold --host 000.001.002.003 --domain domain.com --application appname
```

THE DIFFERENT STEPS

1- Generate the file that will contain the passwords

```
./vendor/bin/deploy password:create
# Enter the password that will be used for decryption
# This password must be saved in clear in the .vaultpass file
# This file must not be versioned.
```

2- Add theses variables with the correct data

```
# The deployement user password. The user created on the server.
vault_user_password: "password"

# The deployment database password
vault_database_password: "password"

# The database root user password
vault_database_root_password: "password"

# The administrator password for admin panel in local
vault_admin_local_password: "password"

# The administrator password for admin panel in production
vault_admin_production_password: "password"

# The ftp password for backup. Can be blank.
vault_ftp_password: "password"

# Copy and paste the output of *php artisan key:generate --show command
vault_app_key: "base64:appkey"
```

3- To modify the file containing the passwords

```
./vendor/bin/deploy password:edit
```

4- To view the contents of the file

```
./vendor/bin/deploy password:view
```

4- To delete the contents of the file

```
./vendor/bin/deploy password:delete
```

### Available commands

[](#available-commands)

1. **help**
2. **scaffold**
3. **configure:server**
4. **password:create**
5. **password:view**
6. **password:edit**
7. **password:delete**
8. **run**
9. **rollback**
10. **db:seed**
11. **db:deploy**
12. **db:dump**
13. **db:run**
14. **db:import**
15. **storage:dump**
16. **storage:import**
17. **storage:deploy**
18. **exec**
19. **dkim**
20. **clean**
21. **ssh**
22. **env:deploy**

### Help

[](#help)

Get more informations

```
./vendor/bin/deploy help
```

### Configure server

[](#configure-server)

Run **configure:server** command to install all necessary softwares for a laravel project on the VPS (php, mysql, nginx ...).

```
./vendor/bin/deploy configure:server
```

### Deploy

[](#deploy)

```
./vendor/bin/deploy run
```

### Rollback

[](#rollback)

```
./vendor/bin/deploy rollback
```

### Seed database

[](#seed-database)

```
./vendor/bin/deploy db:seed
```

### Database deploy

[](#database-deploy)

Copy and import local database into remote database

```
./vendor/bin/deploy db:deploy
```

### Database import

[](#database-import)

Copy and import remote database into local database

```
./vendor/bin/deploy db:import
```

### Database dump

[](#database-dump)

Dump local database

```
./vendor/bin/deploy db:dump
```

### Storage deploy

[](#storage-deploy)

Copy and import local storage folder into remote storage folder

```
./vendor/bin/deploy storage:deploy
```

### Storage import

[](#storage-import)

Copy and import remote storage folder into local storage folder

```
./vendor/bin/deploy storage:import
```

### Exec

[](#exec)

Run a shell command online

```
./vendor/bin/deploy exec "pwd"
```

### Dkim

[](#dkim)

Display DKIM public key

```
./vendor/bin/deploy dkim
```

### Clean

[](#clean)

Remove temporary files

```
./vendor/bin/deploy clean
```

### SSH

[](#ssh)

SSH into remote project

```
./vendor/bin/deploy ssh
```

If you discover any security related issues, please email instead of using the issue tracker.

Credits
-------

[](#credits)

- [Guy-roland ASSALE](https://github.com/guysolamour/laravel-administrable-deploy)
- [All contributors](https://github.com/guysolamour/laravel-administrable-deploy/graphs/contributors)

This package is bootstrapped with the help of [melihovv/laravel-package-generator](https://github.com/melihovv/laravel-package-generator).

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~83 days

Total

4

Last Release

815d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/45a6375d79a9d7c7b3947473bef714f03a02bb0341d06e6c17ca114b82b0b01d?d=identicon)[guysolamour](/maintainers/guysolamour)

---

Top Contributors

[![guysolamour](https://avatars.githubusercontent.com/u/22590722?v=4)](https://github.com/guysolamour "guysolamour (6 commits)")

---

Tags

laraveldeploy

### Embed Badge

![Health badge](/badges/guysolamour-laravel-deploy/health.svg)

```
[![Health](https://phpackages.com/badges/guysolamour-laravel-deploy/health.svg)](https://phpackages.com/packages/guysolamour-laravel-deploy)
```

###  Alternatives

[timokoerber/laravel-one-time-operations

Run operations once after deployment - just like you do it with migrations!

6481.7M11](/packages/timokoerber-laravel-one-time-operations)[spatie/laravel-prometheus

Export Laravel metrics to Prometheus

2651.3M6](/packages/spatie-laravel-prometheus)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)