Manual de Despliegue de EspoCRM con Docker

Este manual describe paso a paso cómo desplegar EspoCRM usando Docker y Docker Compose, incluyendo la gestión de credenciales del usuario administrador.

Requisitos Previos

• Tener instalado Docker y Docker Compose.
• Acceso a terminal con permisos de superusuario.

1. Crear el archivo docker-compose.yml

Crea un archivo llamado docker-compose.yml con el siguiente contenido:

dervices:
  espo-db:
    image: mariadb:10.6
    container_name: espo-db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: espo
      MYSQL_USER: espo_user
      MYSQL_PASSWORD: espo_pass
    volumes:
      - espo_db_data:/var/lib/mysql

  espocrm:
    image: espocrm/espocrm:latest
    container_name: espocrm
    restart: unless-stopped
    depends_on:
      - espo-db
    environment:
      ESPOCRM_DATABASE_DRIVER: mysqli
      ESPOCRM_DATABASE_HOST: espo-db
      ESPOCRM_DATABASE_PORT: 3306
      ESPOCRM_DATABASE_NAME: espo
      ESPOCRM_DATABASE_USER: espo_user
      ESPOCRM_DATABASE_PASSWORD: espo_pass
    volumes:
      - espo_data:/var/www/html
    ports:
      - "8080:80"

volumes:
  espo_db_data:
  espo_data:

2. Desplegar los contenedores

Ejecuta el siguiente comando en el directorio donde se encuentra el docker-compose.yml:

docker compose up -d

3. Acceder a la interfaz web de EspoCRM

Una vez que los contenedores estén levantados, accede a la aplicación desde tu navegador:

http://localhost:8080

Si el puerto 8080 ya está en uso, edita el docker-compose.yml y cambia la línea:

- "8080:80"

por otro puerto, como:

- "8085:80"

Y vuelve a levantar los contenedores:

docker compose down -v
# Edita el puerto y luego
docker compose up -d

4. Restablecer contraseña del usuario administrador

Si ya está instalada la aplicación y no recuerdas la contraseña del usuario admin, puedes restablecerla así:

4.1. Acceder al contenedor de EspoCRM

docker exec -it espocrm bash

4.2. Cambiar la contraseña con el comando adecuado

php command.php set-password admin nuevacontrasena

Sustituye nuevacontrasena por la contraseña que desees.

4.3. Salir del contenedor

exit

5. Crear un nuevo usuario administrador (opcional)

Si no conoces el usuario existente o deseas crear uno nuevo:

docker exec -it espocrm bash
php command.php create-admin-user nuevoadmin admin@example.com nuevacontrasena
exit

6. Documentación adicional

Puedes consultar la documentación oficial en:

https://docs.espocrm.com/administration/commands/

---

Fin del manual