Download the PHP package itcompass/basepack without Composer

Overview

BasePack is a comprehensive DevOps toolkit that streamlines Docker-based Laravel development and deployment. It provides pre-configured Docker containers, SSL certificate management, intelligent diagnostics, and powerful automation commands - everything you need to go from development to production seamlessly.

Built by developers, for developers - BasePack eliminates the complexity of Docker configuration while maintaining flexibility for customization.

Why BasePack?

• Zero Configuration - Install and run in minutes with smart defaults
• Production Ready - Separate dev/prod configurations with security hardening
• SSL Made Easy - Automatic certificate detection and validation
• Smart Diagnostics - Auto-fix common issues with built-in diagnostic tools
• Real-time Monitoring - Live dashboard for container stats and health checks
• Full Stack Included - PHP, Nginx, MySQL, Redis, with Xdebug for development
• Battle Tested - Comprehensive test coverage across PHP 8.1-8.3 and Laravel 10-12

Features

🚀 Quick Setup & Automation

• One-Command Installation - php artisan basepack:install sets up everything
• Smart SSL Detection - Automatically finds and validates certificates from 6+ locations
• Project Name Inference - Intelligently detects project name from various sources
• Makefile Integration - 295 lines of pre-configured Make commands for common tasks

🐳 Docker Environment

• Multi-Version PHP Support - PHP 8.1, 8.2, 8.3 with FPM
• Modern Stack - Nginx, MySQL 8.0, Redis 7.4
• Xdebug Integration - Pre-configured for PhpStorm and VSCode
• Separate Configurations - Optimized dev and production environments
• Security Hardened - Redis authentication, protected mode, disabled dangerous commands (CVE-2025-49844 mitigation)

🛠 Artisan Commands

📊 Monitoring & Diagnostics

• Real-time Dashboard - CPU, memory, port mappings, health checks
• Smart Diagnostics - Detects missing files, invalid configs, SSL issues
• Auto-Fix Capability - One-command resolution of common problems
• Detailed Reporting - Clear, actionable feedback with next steps

🔒 Security Features

• Redis Security Hardening - Password auth, protected mode, network isolation
• CVE-2025-49844 Mitigation - Disabled dangerous Lua scripting commands
• SSL/TLS Support - Self-signed or production certificates
• No Public Exposure - Redis and MySQL accessible only via internal Docker network
• Environment Validation - Checks for weak passwords and security misconfigurations

Requirements

• PHP 8.1, 8.2, or 8.3
• Laravel 10.x, 11.x, or 12.x
• Docker & Docker Compose
• Make (optional, but recommended)

Installation

1. Install via Composer

2. Run Installation Wizard

The installer will:

• Detect or prompt for SSL certificates
• Create .env.docker with secure defaults
• Publish Docker configuration files
• Generate Makefile for automation
• Create docker-compose files for dev/prod
• Update .gitignore with sensible defaults

3. Configure Environment

Option A: New Project

Option B: Existing Project

Important: Change default passwords!

Generate strong passwords:

4. Build and Start

5. Access Your Application

Quick Start

Development Workflow

Production Deployment

Monitoring & Debugging

Configuration

Project Structure

After installation, BasePack creates:

Environment Variables

Key variables in .env.docker:

SSL Certificates

BasePack looks for SSL certificates in these locations (in order):

1. ./ssl/
2. ./.ssl/
3. ./certificates/
4. ./.docker/ssl/
5. /etc/ssl/certs/
6. ~/.ssl/

Or specify custom path:

Certificate Requirements:

• Files must be named cert.pem and key.pem
• For development: self-signed certificates work fine
• For production: use valid certificates (Let's Encrypt recommended)

Generate self-signed certificate:

Makefile Commands

BasePack includes a comprehensive Makefile with 30+ commands:

Container Management

Development

Composer & NPM

Database

Cache & Queue

Testing

Advanced Usage

Custom Container Commands

Selective Publishing

Environment-Specific Installation

Xdebug Configuration

BasePack includes pre-configured Xdebug for development:

PhpStorm:

1. Enable Xdebug in .env.docker: XDEBUG_CONFIG=main
2. Configure PhpStorm: Settings → PHP → Servers
3. Add server with name localhost and port 80
4. Enable "Start listening for PHP Debug Connections"

VSCode:

1. Use .docker/dev/xdebug-main.ini configuration
2. Install PHP Debug extension
3. Configure launch.json with provided settings

macOS Users:

• Use XDEBUG_CONFIG=osx for Docker Desktop on macOS
• Uses xdebug-osx.ini with Docker host gateway

Testing

BasePack includes comprehensive tests across three tiers:

Running Tests

Test Coverage

BasePack is tested against:

• PHP Versions: 8.1, 8.2, 8.3
• Laravel Versions: 10.x, 11.x, 12.x
• Dependency Variants: prefer-lowest, prefer-stable
• Total Matrix Combinations: 14 test scenarios

See TESTING.md for detailed testing documentation.

Security

Security Hardening

BasePack implements comprehensive security measures:

Redis Security (CVE-2025-49844 Mitigation):

• Password authentication required
• Protected mode enabled
• Network isolation (no public exposure)
• Dangerous commands disabled (FLUSHDB, FLUSHALL, CONFIG, etc.)
• Updated to Redis 7.4-alpine with latest patches

Before Production Deployment:

• [ ] Change all default passwords
• [ ] Use strong passwords (32+ characters)
• [ ] Verify Redis is not publicly exposed
• [ ] Use valid SSL certificates
• [ ] Review .gitignore excludes sensitive files
• [ ] Run php artisan basepack:diagnose --fix

Reporting Vulnerabilities

See SECURITY.md for our security policy and how to report vulnerabilities.

Contact: [email protected]

Troubleshooting

Common Issues

Containers won't start:

SSL certificate errors:

Permission issues:

Redis connection refused:

Xdebug not working:

Getting Help

1. Run diagnostics: php artisan basepack:diagnose
2. Check logs: make logs
3. Review configuration: php artisan basepack:status
4. Consult SECURITY.md
5. Open an issue

Contributing

We welcome contributions! Please follow these guidelines:

Development Setup

Contribution Workflow

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Write tests for your changes
4. Ensure all tests pass (vendor/bin/phpunit)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to your branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Code Standards

• Follow PSR-12 coding standards
• Write comprehensive tests (unit, integration, feature)
• Document new features in README.md
• Update CHANGELOG.md with your changes
• Ensure CI/CD pipeline passes

Testing Requirements

All contributions must include tests and pass the full test matrix:

• PHP 8.1, 8.2, 8.3
• Laravel 10.x, 11.x, 12.x
• Both prefer-lowest and prefer-stable dependencies

Changelog

Please see CHANGELOG.md for recent changes.

Credits

Created By

ITCompass - Digital Solutions Agency

• Website: itcompass.io
• Email: [email protected]

Lead Developer

Artem Shevchenko (@ibigforko)

Contributors

See all contributors who have helped make BasePack better.

License

BasePack is open-source software licensed under the MIT License.

Copyright (c) 2025 ITCompass

Support

Commercial Support

Need help with implementation, custom features, or dedicated support?

Contact us: [email protected]

Community Support

• GitHub Issues - Bug reports and feature requests
• GitHub Discussions - Questions and community help

Acknowledgments

BasePack is built with and inspired by these amazing projects:

• Laravel - The PHP Framework for Web Artisans
• Docker - Containerization platform
• Redis - In-memory data structure store
• Nginx - High-performance web server
• MySQL - Popular open-source database