{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/espocrm",
  "slug": "espocrm",
  "name": "EspoCRM",
  "tagline": "Customer relationship management web app for contacts, accounts, leads and sales.",
  "replaces": {
    "summary": "Paid CRM services, such as Salesforce.",
    "products": [
      {
        "slug": "salesforce",
        "name": "Salesforce",
        "vendor": "Salesforce",
        "url": "https://openlogs.fyi/alternatives/salesforce"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "PHP"
    },
    {
      "kind": "database",
      "name": "MariaDB"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "AGPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/espocrm/espocrm/blob/ddd727b31a4289cf5c4a295d0cf1618af865a93c/LICENSE.txt"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/espocrm/espocrm/blob/ddd727b31a4289cf5c4a295d0cf1618af865a93c/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "4 services (1 database or broker: mariadb), 4 volume mounts, no env values to set, no elevated host access. Heuristic score 5 of 11: medium."
  },
  "repository": {
    "owner": "espocrm",
    "name": "espocrm",
    "url": "https://github.com/espocrm/espocrm"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docs/administration/docker/installation.md",
    "source_repo": "espocrm/documentation",
    "source_commit_sha": "83c4d13db362eea1c6f220cdab14304344c3e718",
    "source_kind": "packaging_repo",
    "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md#L178-L272",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the code block as docker-compose.yml",
      "body": "services:\n\n  espocrm-db:\n    image: mariadb:latest\n    container_name: espocrm-db\n    environment:\n      MARIADB_ROOT_PASSWORD: database_root_password\n      MARIADB_DATABASE: espocrm\n      MARIADB_USER: espocrm\n      MARIADB_PASSWORD: database_password\n    volumes:\n      - espocrm-db:/var/lib/mysql\n    restart: unless-stopped\n    healthcheck:\n      test: [\"CMD\", \"healthcheck.sh\", \"--connect\", \"--innodb_initialized\"]\n      interval: 20s\n      start_period: 10s\n      timeout: 10s\n      retries: 3\n\n  espocrm:\n    image: espocrm/espocrm:latest\n    container_name: espocrm\n    environment:\n      ESPOCRM_DATABASE_HOST: espocrm-db\n      ESPOCRM_DATABASE_USER: espocrm\n      ESPOCRM_DATABASE_PASSWORD: database_password\n      ESPOCRM_ADMIN_USERNAME: admin\n      ESPOCRM_ADMIN_PASSWORD: admin_password\n      ESPOCRM_SITE_URL: \"http://localhost:8080\"\n    volumes:\n      - espocrm-data:/var/www/html/data\n      - espocrm-custom:/var/www/html/custom\n      - espocrm-custom-client:/var/www/html/client/custom\n    restart: unless-stopped\n    depends_on:\n      espocrm-db:\n        condition: service_healthy\n    healthcheck:\n      test: [\"CMD\", \"bin/command\", \"app-check\"]\n      start_period: 20s\n      interval: 60s\n      timeout: 20s\n      retries: 3\n    ports:\n      - 8080:80\n\n  espocrm-daemon:\n    image: espocrm/espocrm:latest\n    container_name: espocrm-daemon\n    volumes_from:\n      - espocrm\n    restart: unless-stopped\n    entrypoint: docker-daemon.sh\n    depends_on:\n      espocrm:\n        condition: service_healthy\n    healthcheck:\n      test: [\"CMD\", \"bin/command\", \"app-check\"]\n      start_period: 20s\n      interval: 180s\n      timeout: 20s\n      retries: 3\n\n  espocrm-websocket:\n    image: espocrm/espocrm:latest\n    container_name: espocrm-websocket\n    environment:\n      ESPOCRM_CONFIG_USE_WEB_SOCKET: \"true\"\n      ESPOCRM_CONFIG_WEB_SOCKET_URL: \"ws://localhost:8081\"\n      ESPOCRM_CONFIG_WEB_SOCKET_ZERO_M_Q_SUBSCRIBER_DSN: \"tcp://*:7777\"\n      ESPOCRM_CONFIG_WEB_SOCKET_ZERO_M_Q_SUBMISSION_DSN: \"tcp://espocrm-websocket:7777\"\n    volumes_from:\n      - espocrm\n    restart: unless-stopped\n    entrypoint: docker-websocket.sh\n    depends_on:\n      espocrm:\n        condition: service_healthy\n    healthcheck:\n      test: [\"CMD\", \"bin/command\", \"app-check\"]\n      start_period: 20s\n      interval: 180s\n      timeout: 20s\n      retries: 3\n    ports:\n      - 8081:8080\n\nvolumes:\n  espocrm-db:\n  espocrm-data:\n  espocrm-custom:\n  espocrm-custom-client:\n",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "This compose file is copied unchanged from the code block in https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md#L178-L272. The check ran on that block alone. The Docker installation guide shows this docker-compose.yml and tells the reader to run docker compose up -d.",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md#L178-L272",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:8080. The compose file publishes host port 8080 for the espocrm service.",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: espocrm-db: mariadb:latest, espocrm: espocrm/espocrm:latest, espocrm-daemon: espocrm/espocrm:latest, espocrm-websocket: espocrm/espocrm:latest. A later pull can get a different version.",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 8080 (espocrm), 8081 (espocrm-websocket). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/espocrm/documentation/blob/83c4d13db362eea1c6f220cdab14304344c3e718/docs/administration/docker/installation.md",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 3508,
    "forks": 1014,
    "open_issues": 66,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "10.0.10",
    "latest_release_date": "2026-10-14",
    "days_since_release": 8
  },
  "links": {
    "html": "https://openlogs.fyi/tools/espocrm",
    "markdown": "https://openlogs.fyi/tools/espocrm.md",
    "json": "https://openlogs.fyi/tools/espocrm.json"
  },
  "updated_at": "2026-10-22"
}