kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-10-10 10:48:10 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
6824e444b0f0436e6b385fbba36d32044ed26c17
computer-playbook/roles/web-app-espocrm
History
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
meta
Replaced .infinito.service and .infinito.timer by SOFTWARE_NAME suffix, optimized LICENSE link and update OIDC Realm and ID conf
2025-08-14 14:39:18 +02:00
schema
Implemented schema/main.yml und config/main.yml file
2025-07-09 02:03:32 +02:00
tasks
EspoCRM role: custom image + single data volume + runtime flag setter
2025-10-01 14:08:09 +02:00
templates
EspoCRM role: custom image + single data volume + runtime flag setter
2025-10-01 14:08:09 +02:00
users
Restructured users
2025-07-09 02:26:50 +02:00
vars
EspoCRM role: custom image + single data volume + runtime flag setter
2025-10-01 14:08:09 +02:00
README.md
Refactor: migrate cmp/* and srv/* roles into sys-stk/* and sys-svc/* namespaces
2025-08-28 22:23: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 ⚖️