277 lines
7.1 KiB
Markdown
Executable File
277 lines
7.1 KiB
Markdown
Executable File
# Environment Setup Guide
|
|
|
|
Panduan lengkap untuk setup environment file CKB Laravel Application dengan file template terpisah untuk local dan production.
|
|
|
|
## 📂 File Structure
|
|
|
|
```
|
|
docker/
|
|
├── env.example.local # Template untuk local development
|
|
├── env.example.production # Template untuk production
|
|
└── (env.example) # File lama, dapat dihapus
|
|
```
|
|
|
|
## 🔧 Quick Setup
|
|
|
|
### Local Development
|
|
|
|
```bash
|
|
# Setup environment untuk local development
|
|
./docker-setup-env.sh local
|
|
|
|
# Atau manual copy
|
|
cp docker/env.example.local .env
|
|
```
|
|
|
|
### Production Deployment
|
|
|
|
```bash
|
|
# Setup environment untuk production
|
|
./docker-setup-env.sh production
|
|
|
|
# IMPORTANT: Edit .env dan ganti semua CHANGE_THIS_* values!
|
|
nano .env
|
|
```
|
|
|
|
## 📋 Template Comparison
|
|
|
|
### 🏠 Local Development (`env.example.local`)
|
|
|
|
| Setting | Value | Description |
|
|
| ------------------- | ----------------------- | ----------------------- |
|
|
| `APP_ENV` | `local` | Development environment |
|
|
| `APP_DEBUG` | `true` | Debug mode enabled |
|
|
| `APP_URL` | `http://localhost:8000` | Local URL |
|
|
| `LOG_LEVEL` | `debug` | Verbose logging |
|
|
| `DB_DATABASE` | `ckb_db` | Development database |
|
|
| `DB_USERNAME` | `root` | Simple credentials |
|
|
| `DB_PASSWORD` | `root` | Simple credentials |
|
|
| `REDIS_PASSWORD` | `null` | No password needed |
|
|
| `MAIL_HOST` | `mailhog` | Local mail testing |
|
|
| `QUEUE_CONNECTION` | `sync` | Synchronous queue |
|
|
| `TELESCOPE_ENABLED` | `true` | Debugging tool enabled |
|
|
|
|
### 🚀 Production (`env.example.production`)
|
|
|
|
| Setting | Value | Description |
|
|
| ------------------- | ---------------------------------- | ----------------------- |
|
|
| `APP_ENV` | `production` | Production environment |
|
|
| `APP_DEBUG` | `false` | Debug mode disabled |
|
|
| `APP_URL` | `https://bengkel.digitaloasis.xyz` | Production domain |
|
|
| `LOG_LEVEL` | `error` | Error-only logging |
|
|
| `DB_DATABASE` | `ckb_production` | Production database |
|
|
| `DB_USERNAME` | `ckb_user` | Secure username |
|
|
| `DB_PASSWORD` | `CHANGE_THIS_*` | **Must be changed!** |
|
|
| `REDIS_PASSWORD` | `CHANGE_THIS_*` | **Must be changed!** |
|
|
| `MAIL_HOST` | `smtp.gmail.com` | Real SMTP server |
|
|
| `QUEUE_CONNECTION` | `redis` | Redis-based queue |
|
|
| `TELESCOPE_ENABLED` | `false` | Debugging tool disabled |
|
|
|
|
## 🔐 Security Configuration for Production
|
|
|
|
### Required Changes
|
|
|
|
**MUST CHANGE** these values in production `.env`:
|
|
|
|
```env
|
|
# Strong database passwords
|
|
DB_PASSWORD=your_super_secure_password_here
|
|
DB_ROOT_PASSWORD=your_root_password_here
|
|
|
|
# Redis security
|
|
REDIS_PASSWORD=your_redis_password_here
|
|
|
|
# Mail configuration
|
|
MAIL_USERNAME=your-email@domain.com
|
|
MAIL_PASSWORD=your-app-specific-password
|
|
```
|
|
|
|
### Optional but Recommended
|
|
|
|
```env
|
|
# AWS S3 for file storage
|
|
AWS_ACCESS_KEY_ID=your-aws-key
|
|
AWS_SECRET_ACCESS_KEY=your-aws-secret
|
|
|
|
# Real-time features
|
|
PUSHER_APP_ID=your-pusher-app-id
|
|
PUSHER_APP_KEY=your-pusher-key
|
|
PUSHER_APP_SECRET=your-pusher-secret
|
|
```
|
|
|
|
## 🛠️ Environment Helper Script
|
|
|
|
### Usage
|
|
|
|
```bash
|
|
# Setup local environment
|
|
./docker-setup-env.sh local
|
|
|
|
# Setup production environment
|
|
./docker-setup-env.sh production
|
|
|
|
# Show current environment info
|
|
./docker-setup-env.sh
|
|
```
|
|
|
|
### Features
|
|
|
|
- ✅ **Auto-backup** existing `.env` before changes
|
|
- ✅ **Environment validation** checks required variables
|
|
- ✅ **Security warnings** for production misconfiguration
|
|
- ✅ **Configuration summary** shows current settings
|
|
- ✅ **Next steps guidance** for deployment
|
|
|
|
## 📊 Environment Comparison
|
|
|
|
### Local Development Features
|
|
|
|
- 🐛 **Debug Mode**: Full error reporting and debugging tools
|
|
- 📧 **MailHog**: Local email testing server
|
|
- 🗄️ **Simple DB**: Basic MySQL credentials
|
|
- 🔓 **No SSL**: HTTP-only for speed
|
|
- 🧪 **Development Tools**: Telescope, Debugbar enabled
|
|
- ⚡ **Sync Queue**: Immediate processing for testing
|
|
|
|
### Production Features
|
|
|
|
- 🔒 **Security First**: Strong passwords and encryption
|
|
- 📧 **Real SMTP**: Professional email delivery
|
|
- 🗄️ **Secure DB**: Production-grade credentials
|
|
- 🔐 **SSL/HTTPS**: Let's Encrypt certificates
|
|
- 📊 **Monitoring**: Error-only logging
|
|
- 🚀 **Redis Queue**: Background job processing
|
|
|
|
## 🚨 Common Issues & Solutions
|
|
|
|
### 1. "CHANGE*THIS*\*" Values in Production
|
|
|
|
**Problem**: Forgot to change template values
|
|
|
|
```bash
|
|
# Check for remaining template values
|
|
grep "CHANGE_THIS" .env
|
|
```
|
|
|
|
**Solution**:
|
|
|
|
```bash
|
|
# Use the helper script to check
|
|
./docker-setup-env.sh
|
|
# It will warn about CHANGE_THIS_* values
|
|
```
|
|
|
|
### 2. Wrong Environment File
|
|
|
|
**Problem**: Using local config in production
|
|
|
|
```bash
|
|
# Check current environment
|
|
grep "APP_ENV=" .env
|
|
```
|
|
|
|
**Solution**:
|
|
|
|
```bash
|
|
# Recreate with correct template
|
|
./docker-setup-env.sh production
|
|
```
|
|
|
|
### 3. Missing Environment Variables
|
|
|
|
**Problem**: Laravel errors about missing config
|
|
|
|
```bash
|
|
# Validate current .env
|
|
./docker-setup-env.sh validate
|
|
```
|
|
|
|
**Solution**: Check required variables list and add missing ones
|
|
|
|
## 📝 Environment Variables Reference
|
|
|
|
### Core Application
|
|
|
|
```env
|
|
APP_NAME="CKB Bengkel System"
|
|
APP_ENV=production|local
|
|
APP_KEY=base64:...
|
|
APP_DEBUG=true|false
|
|
APP_URL=https://domain.com
|
|
```
|
|
|
|
### Database
|
|
|
|
```env
|
|
DB_CONNECTION=mysql
|
|
DB_HOST=db
|
|
DB_PORT=3306
|
|
DB_DATABASE=ckb_production|ckb_db
|
|
DB_USERNAME=username
|
|
DB_PASSWORD=password
|
|
DB_ROOT_PASSWORD=root_password
|
|
```
|
|
|
|
### Cache & Session
|
|
|
|
```env
|
|
REDIS_HOST=redis
|
|
REDIS_PASSWORD=password|null
|
|
REDIS_PORT=6379
|
|
CACHE_DRIVER=redis
|
|
SESSION_DRIVER=redis
|
|
QUEUE_CONNECTION=redis|sync
|
|
```
|
|
|
|
### Mail Configuration
|
|
|
|
```env
|
|
MAIL_MAILER=smtp
|
|
MAIL_HOST=smtp.domain.com
|
|
MAIL_PORT=587
|
|
MAIL_USERNAME=email@domain.com
|
|
MAIL_PASSWORD=password
|
|
MAIL_ENCRYPTION=tls
|
|
MAIL_FROM_ADDRESS=noreply@domain.com
|
|
MAIL_FROM_NAME="${APP_NAME}"
|
|
```
|
|
|
|
### Security
|
|
|
|
```env
|
|
TRUSTED_PROXIES=*
|
|
SESSION_SECURE_COOKIE=true
|
|
SESSION_SAME_SITE=strict
|
|
```
|
|
|
|
## 🔄 Migration Guide
|
|
|
|
### From Old Single Template
|
|
|
|
If you're migrating from the old `docker/env.example`:
|
|
|
|
```bash
|
|
# Backup current .env
|
|
cp .env .env.backup
|
|
|
|
# Choose appropriate template
|
|
./docker-setup-env.sh local # for development
|
|
./docker-setup-env.sh production # for production
|
|
|
|
# Compare and migrate custom settings
|
|
diff .env.backup .env
|
|
```
|
|
|
|
## 📞 Support
|
|
|
|
For environment setup issues:
|
|
|
|
- **Documentation**: This file
|
|
- **Helper Script**: `./docker-setup-env.sh`
|
|
- **Validation**: Built-in security checks
|
|
- **Backup**: Automatic .env backup before changes
|
|
|
|
---
|
|
|
|
**💡 Pro Tip**: Always use the helper script `./docker-setup-env.sh` instead of manual copying to ensure proper configuration and security checks!
|