Files
computer-playbook/roles/web-app-espocrm/README.md
Kevin Veen-Birkenbach 6ea8301364 Refactor: migrate cmp/* and srv/* roles into sys-stk/* and sys-svc/* namespaces
- Removed obsolete 'cmp' category, introduced 'stk' category (fa-bars-staggered icon).
- Renamed roles:
  * cmp-db-docker → sys-stk-back-stateful
  * cmp-docker-oauth2 → sys-stk-back-stateless
  * srv-domain-provision → sys-stk-front
  * cmp-db-docker-proxy → sys-stk-full-stateful
  * cmp-docker-proxy → sys-stk-full-stateless
  * cmp-rdbms → sys-svc-rdbms
- Updated all include_role references, vars, templates and README.md files.
- Adjusted run_once comments and variable paths accordingly.
- Updated all web-app roles to use new sys-stk/* and sys-svc/* roles.

Conversation: https://chatgpt.com/share/68b0ba66-09f8-800f-86fc-76c47009d431
2025-08-28 22:23:09 +02:00

40 lines
1.8 KiB
Markdown

# 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
- [EspoCRM Official Website](https://www.espocrm.com/) 🌍
- [EspoCRM Documentation](https://docs.espocrm.com/) 📖
- [Infinito.Nexus Project Repository](https://s.infinito.nexus/code) 🔗
## Credits
Developed and maintained by **Kevin Veen-Birkenbach**.
Consulting & Coaching Solutions: [veen.world](https://www.veen.world) 🌟
Part of the [Infinito.Nexus Project](https://s.infinito.nexus/code) 📂
License: [Infinito.Nexus NonCommercial License](https://s.infinito.nexus/license) ⚖️