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

Command	Description
`setup`	Full WordPress setup 🌱
`install`	Install WordPress core
`theme`	Activate the KoalaPress theme
`plugins`	Install Composer plugins inside the theme
`cleanup`	Delete unused plugins and themes
`lang`	Install and activate WordPress language
`permalinks`	Set permalink structure to `/postname/`
`up`	Start Docker containers
`down`	Stop Docker containers
`restart`	Restart Docker containers
`wp`	Run WP-CLI commands inside the container
`composer`	Run Composer commands inside the theme folder
`acorn`	Run Acorn commands inside the theme
`bin`	Run theme-local `vendor/bin/...` 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

koalapress / euca

Maintainers

Details