Laraship NPM | npm.io

LaraShip 🚢

Set sail with Laravel! LaraShip is the ultimate Docker environment generator for Laravel projects. It helps you quickly set up a production-ready Docker environment with zero configuration.

Version Downloads License

✨ Features

🐳 One-Command Setup

With a single command, you’re ready to sail:

npx laraship

LaraShip will automatically:

Detect your PHP version and extensions
Configure your database
Set up Redis (if needed)
Handle SSL certificates
Configure backups
Set up GitHub Actions

🔹 Zero Configuration Needed

Auto-detects project requirements
Applies sensible production defaults
Allows customization when needed

🚀 Production-Ready

Optimized Dockerfile
Secure database configuration
Built-in health checks
SSL/TLS support
Backup solutions included
Monitoring integrations

📦 Installation

Global Installation (Recommended)

# Install globally
npm install -g laraship

# Use in any Laravel project
cd your-laravel-project
laraship

Using npx (No Installation Required)

cd your-laravel-project
npx laraship

🚀 Quick Start

Navigate to your Laravel project:
```
cd your-laravel-project
```
Run LaraShip:
```
laraship
```
Answer a few questions:
- Database preferences
- Redis setup
- Backup configuration
- Deployment options
Start your containers:
```
docker-compose up -d
```

That’s it! Your Laravel app is now Dockerized and production-ready.

🎮 Usage Examples

Development Setup

cd my-laravel-app
laraship
# Choose MySQL container
# Skip Redis
# Skip backups

Production Setup

cd my-laravel-app
laraship
# Enable MySQL
# Enable Redis
# Configure backups
# Set up GitHub Actions
# Enable SSL

Common Commands

# Start services
docker-compose up -d

# View logs
docker-compose logs -f

# Run migrations
docker-compose exec app php artisan migrate

# Stop services
docker-compose down