README

EUCA is a lightweight command-line tool to manage a Docker-based WordPress development environment – optimized for KoalaPress themes.

🌿 Streamlined setup with Docker, WP-CLI, Composer, and Acorn.

📦 Installation

Via Composer

composer require --dev koalapress/euca

You can now run the CLI like this:

./vendor/bin/euca

Optional: make it available globally

composer global require koalapress/euca
euca

Requirements

• Docker + Docker Compose v2+
• Composer
• WP-CLI installed inside your container
• Optionally: xdg-open, open, or start for browser support

🚀 Usage

./vendor/bin/euca <command> [--no-open]

Available Commands

⚙️ Configuration

All settings are controlled via a .env file in your project root:

PROJECT_NAME=koala
SERVICE=wordpress
DOMAIN=koala.localhost
ADMIN_USER=admin
ADMIN_PASS=admin
ADMIN_EMAIL=admin@example.com
SITE_TITLE="My KoalaPress Site"
LOCALE=de_DE

If no .env is found, one will be auto-generated or copied from .env.example.

🔐 Admin Login

After setup, the login URL (/wp-admin) is automatically opened.

• Username: admin (or from .env)
• Password: admin (or from .env)

📁 Recommended Project Structure

my-project/
├── docker-compose.yml
├── .env
├── build/
│   (with its own composer.json)

🧪 Example

# Run full setup
./vendor/bin/euca setup

# Activate theme
./vendor/bin/euca theme

# Stop containers
./vendor/bin/euca down

📝 License

MIT © KoalaPress