mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-10-31 10:19:09 +00:00

Files

Kevin Veen-Birkenbach e7702948b8 EspoCRM role: custom image + single data volume + runtime flag setter

• Build a custom image and replace upstream entrypoint with docker-entrypoint-custom.sh (strict fail on flag script).

• Introduce set_flags.php and wire via ESPOCRM_SET_FLAGS_SCRIPT; apply flags at container start; clear cache afterwards.

• Keep exactly one Docker volume (data:/var/www/html/); drop separate custom/extensions mounts.

• Compose: use custom image, add healthchecks & depends_on for daemon/websocket; keep service healthy gating.

• Ansible: deploy scripts, build & up via handlers; patch siteUrl as www-data; run upgrade non-fatal; always run flag setter.

• Vars/Env: add ESPO_INIT_* toggles and ESPOCRM_SET_FLAGS_SCRIPT; refactor variables for scripts & custom image paths.

Conversation context: https://chatgpt.com/share/68dd1992-020c-800f-bcf5-2db60cb4aab2

2025-10-01 14:08:09 +02:00

config

EspoCRM role: custom image + single data volume + runtime flag setter

2025-10-01 14:08:09 +02:00

files

EspoCRM role: custom image + single data volume + runtime flag setter

2025-10-01 14:08:09 +02:00

README.md

EspoCRM

Description

Enhance your sales and service processes with EspoCRM, an open-source CRM featuring workflow automation, LDAP/OIDC single sign-on, and a sleek, lightweight UI! 🚀💼

Overview

This Ansible role deploys EspoCRM using Docker. It handles:

MariaDB database provisioning via the sys-svc-rdbms role
Nginx domain setup with WebSocket and reverse-proxy configuration
Environment variable management through Jinja2 templates
Docker Compose orchestration for web, daemon, and websocket services
Automatic OIDC scope configuration within the EspoCRM container

With this role, you'll have a production-ready CRM environment that's secure, scalable, and real-time.

Features

Workflow Automation: Create and manage automated CRM processes with ease 🛠️
LDAP/OIDC SSO: Integrate with corporate identity providers for seamless login 🔐
WebSocket Notifications: Real-time updates via ZeroMQ and WebSockets 🌐
Config via Templates: Fully customizable .env and docker-compose.yml with Jinja2 ⚙️
Health Checks & Logging: Monitor service health and logs with built-in checks and journald 📈
Modular Role Composition: Leverages central roles for database and Nginx, ensuring consistency across deployments 🔄

Further Resources

Credits

Developed and maintained by Kevin Veen-Birkenbach.
Consulting & Coaching Solutions: veen.world 🌟
Part of the Infinito.Nexus Project 📂
License: Infinito.Nexus NonCommercial License ⚖️