Joomla Docker CLI

A robust, production-ready toolset for spinning up Joomla sites instantly using Docker.

Features

• 🚀 Instant Setup: Create a full Joomla + MySQL stack in seconds.
• 🔄 Smart Port Management: Automatically finds available ports (no collisions).
• 🛠 Interactive Mode: Prompts for details if arguments are missing.
• 📊 Dashboard: View all running sites, keys URLs, and status in one CLI view.
• 🛡 Production Ready: Optimized Docker compose templates with restart policies.

Getting Started

Prerequisites

• Docker Desktop

Installation

git clone https://github.com/siddik-web/joomla-docker-cli.git
cd joomla-docker-cli
chmod u+x *.sh

Usage

1. Create a Site

Run interactively:

./create-site.sh

Or non-interactively:

# Usage: ./create-site.sh <site_name> [username] [email] [password]
./create-site.sh my-shop admin admin@example.com secret123

2. List Active Sites

Check which sites are running and on what ports:

./list-sites.sh

Output:

SITE NAME                 PORT       STATUS          URL                           
---------                 ----       ------          ---                           
easystore-demo            8080       Running 🟢    http://localhost:8080         
my-shop                   8081       Running 🟢    http://localhost:8081

3. Remove a Site

Safely teardown containers and volumes:

./remove-site.sh my-shop

Configuration

The template.yml file acts as the blueprint for new sites. It includes:

• Joomla: Latest stable image.
• MySQL: Version 8.0.
• Persistence: Named volumes for DB and Web data.
• Restart Policy: unless-stopped (auto-restart on reboot).

Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

License

This project is licensed under the MIT License.