feat: add automation improvements

- Switch to netresearch/ofelia image (fixes command syntax)
- Auto-generate random passwords in make setup
- Add make install command for CLI-based Moodle installation
- Add make configure-cache for programmatic Valkey MUC setup
- Mount scripts directory for automation tools
- Fix sed delimiter in Makefile to handle special chars in passwords

Author: CybotTM

Makefile

@@ -35,7 +35,7 @@ clone-moodle: ## Clone Moodle repository (shallow clone, tip only)
 	@cd moodle && git branch
 	@echo "✅ Moodle cloned successfully"
 
-setup: ## Create .env file from template
+setup: ## Create .env file with random passwords
 	@if [ -f ".env" ]; then \
 		echo "⚠️  .env file already exists"; \
 		read -p "Overwrite? [y/N] " confirm; \
@@ -44,9 +44,16 @@ setup: ## Create .env file from template
 			exit 1; \
 		fi; \
 	fi
-	cp .env.example .env
-	@echo "⚠️  IMPORTANT: Edit .env and set secure passwords!"
-	@echo "   Required: DB_PASSWORD, DB_ROOT_PASSWORD, VALKEY_PASSWORD"
+	@echo "📝 Creating .env file with random passwords..."
+	@cp .env.example .env
+	@DB_PASS=$$(openssl rand -base64 32); \
+	DB_ROOT_PASS=$$(openssl rand -base64 32); \
+	VALKEY_PASS=$$(openssl rand -base64 32); \
+	sed -i "s|CHANGE_ME_SECURE_PASSWORD_HERE|$$DB_PASS|" .env; \
+	sed -i "s|CHANGE_ME_SECURE_ROOT_PASSWORD_HERE|$$DB_ROOT_PASS|" .env; \
+	sed -i "s|CHANGE_ME_SECURE_VALKEY_PASSWORD_HERE|$$VALKEY_PASS|" .env
+	@echo "✅ .env file created with secure random passwords"
+	@echo "   Review and customize: nano .env"
 
 start: ## Start all services (pulls pre-built image)
 	docker compose $(COMPOSE_FILES) up -d
@@ -129,6 +136,42 @@ pull: ## Pull latest pre-built image from GHCR
 	docker compose $(COMPOSE_FILES) pull moodle
 	@echo "✅ Latest image pulled"
 
+install: ## Run Moodle CLI installer
+	@if [ ! -f ".env" ]; then \
+		echo "❌ .env file not found. Run 'make setup' first."; \
+		exit 1; \
+	fi
+	@echo "🚀 Installing Moodle via CLI..."
+	@export $$(grep -v '^#' .env | xargs) && docker compose $(COMPOSE_FILES) exec -T moodle php admin/cli/install.php \
+		--lang=en \
+		--wwwroot=$${MOODLE_SITE_URL} \
+		--dataroot=/var/moodledata \
+		--dbtype=mariadb \
+		--dbhost=database \
+		--dbname=moodle \
+		--dbuser=moodleuser \
+		--dbpass=$${DB_PASSWORD} \
+		--prefix=mdl_ \
+		--fullname="Moodle LMS" \
+		--shortname="Moodle" \
+		--adminuser=admin \
+		--adminpass=Admin123! \
+		--adminemail=admin@example.com \
+		--non-interactive \
+		--agree-license
+	@echo ""
+	@echo "✅ Moodle installed successfully!"
+	@echo "   URL: http://localhost:8080"
+	@echo "   User: admin"
+	@echo "   Pass: Admin123!"
+	@echo ""
+	@echo "⚠️  IMPORTANT: Change the admin password immediately!"
+
+configure-cache: ## Configure Valkey for Moodle Universal Cache (MUC)
+	@echo "🔧 Configuring Valkey for application cache..."
+	docker compose $(COMPOSE_FILES) exec -T moodle php /var/www/scripts/configure-valkey-cache.php
+	@echo "✅ Valkey cache configured"
+
 upgrade-moodle: ## Upgrade Moodle code to latest in branch
 	@if [ ! -d "moodle" ]; then \
 		echo "❌ Moodle directory not found. Run 'make clone-moodle' first."; \

compose.yml

@@ -23,6 +23,8 @@ services:
       - moodledata:/var/moodledata:rw
       # Custom Moodle configuration
       - ./config/moodle-config.php:/var/www/html/config.php:ro
+      # Scripts for automation
+      - ./scripts:/var/www/scripts:ro
     environment:
       # Database
       - DB_TYPE=${DB_TYPE:-mariadb}
@@ -109,15 +111,15 @@ services:
 
   # Ofelia Cron Scheduler
   ofelia:
-    image: mcuadros/ofelia:latest
+    image: ghcr.io/netresearch/ofelia:latest
     container_name: ${COMPOSE_PROJECT_NAME:-moodle45}_ofelia
     restart: unless-stopped
     networks:
       - backend
     volumes:
       # Docker socket for container orchestration
       - /var/run/docker.sock:/var/run/docker.sock:ro
-    command: daemon --docker
+    command: daemon
     depends_on:
       - moodle
 

scripts/configure-valkey-cache.php

@@ -0,0 +1,96 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Configure Valkey/Redis as Moodle Universal Cache (MUC) store
+ *
+ * This script programmatically sets up Valkey for application caching
+ * Run after Moodle installation: make configure-cache
+ */
+
+define('CLI_SCRIPT', true);
+
+require_once('/var/www/html/config.php');
+require_once($CFG->libdir.'/clilib.php');
+
+// Get Valkey credentials from environment
+$valkey_host = getenv('VALKEY_HOST') ?: 'valkey';
+$valkey_port = getenv('VALKEY_PORT') ?: 6379;
+$valkey_password = getenv('VALKEY_PASSWORD') ?: '';
+
+cli_heading('Configuring Valkey/Redis for Moodle Universal Cache (MUC)');
+
+// Load cache configuration
+$factory = cache_factory::instance();
+$config = cache_config::instance();
+
+// Define the Redis store instance
+$store_config = array(
+    'name' => 'valkey',
+    'plugin' => 'redis',
+    'configuration' => array(
+        'server' => $valkey_host . ':' . $valkey_port,
+        'password' => $valkey_password,
+        'prefix' => 'muc_',
+        'serializer' => 1, // PHP serializer (1), or igbinary (2) if available
+        'compressor' => 0, // No compression (0), gzip (1), or zstd (2)
+    ),
+    'features' => 31, // All features enabled
+    'modes' => 3, // Application (1) + Session (2) = 3
+    'mappingsonly' => false,
+    'class' => 'cachestore_redis',
+    'default' => true,
+);
+
+// Check if Valkey store already exists
+$stores = $config->get_all_stores();
+$valkey_exists = false;
+
+foreach ($stores as $store) {
+    if ($store['name'] === 'valkey') {
+        $valkey_exists = true;
+        cli_writeln('Valkey cache store already exists');
+        break;
+    }
+}
+
+if (!$valkey_exists) {
+    cli_writeln('Creating Valkey cache store...');
+
+    // Add the store via admin/cli/cfg.php approach
+    // Note: We need to manipulate the cache config file directly
+    $writer = cache_config_writer::instance();
+    $writer->add_store_instance('valkey', 'redis', $store_config['configuration']);
+
+    cli_writeln('✅ Valkey cache store created successfully');
+    cli_writeln('   Server: ' . $valkey_host . ':' . $valkey_port);
+    cli_writeln('   Database: 1 (separate from sessions on db 0)');
+} else {
+    cli_writeln('ℹ️  Valkey cache store already configured');
+}
+
+// Set Valkey as default application cache
+cli_writeln('');
+cli_writeln('Setting Valkey as default application cache...');
+
+$writer = cache_config_writer::instance();
+$writer->set_mode_mappings(array(
+    cache_store::MODE_APPLICATION => array('valkey', 'default_application'),
+    cache_store::MODE_SESSION => array('default_session'),
+    cache_store::MODE_REQUEST => array('default_request'),
+));
+
+cli_writeln('✅ Valkey configured as default application cache');
+
+// Purge all caches to apply changes
+cli_writeln('');
+cli_writeln('Purging all caches...');
+purge_all_caches();
+
+cli_writeln('✅ Cache configuration complete!');
+cli_writeln('');
+cli_writeln('Verification:');
+cli_writeln('  Visit: Site administration → Plugins → Caching → Configuration');
+cli_writeln('  You should see Valkey/Redis listed as a cache store');
+cli_writeln('');
+
+exit(0);