shinsenter/espocrm repository overview

⁠shinsenter/espocrm

🤝 (PHP) EspoCRM with cron preconfigured, ready in one command

• Docker Hub: https://hub.docker.com/r/shinsenter/espocrm⁠
• GitHub Packages: https://code.shin.company/php/pkgs/container/espocrm⁠
• Main documentation (all environment variables, PHP extensions, hooks, cron): shinsenter/php⁠
• Other pre-built images for popular PHP apps and frameworks: https://hub.docker.com/u/shinsenter⁠

Built on shinsenter/phpfpm-apache⁠ (Apache, PHP-FPM, Composer). For settings shared by all images, see shinsenter/php⁠.

⁠Quick start

New project: mount an empty folder. On first start the container downloads EspoCRM into it (latest release zip of espocrm/espocrm⁠). Watch progress with docker logs -f <container>.

mkdir espocrm
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./espocrm:/var/www/html \
    shinsenter/espocrm:latest

Existing project: mount your code the same way. Changes on the host show up in the container at once.

Compose:

services:
  web:
    image: shinsenter/espocrm:latest
    ports: ["80:80", "443:443", "443:443/udp"]
    volumes:
      - ./espocrm:/var/www/html

The image has no database. Run one as a separate service and pass its address to the app through the app's own settings.

⁠What is inside

Defaults this image sets (you can override each with -e):

⁠Common settings

The full list is in the shinsenter/php⁠ documentation.

⁠HTTPS

The image ships a self-signed certificate for local tests:

• /etc/ssl/site/server.crt
• /etc/ssl/site/server.key

For production, replace both files with your own, by mounting them:

services:
  web:
    image: shinsenter/espocrm:latest
    volumes:
      - ./espocrm:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

or by copying them in your own Dockerfile:

FROM shinsenter/espocrm:latest
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

⁠Extend the image

FROM shinsenter/espocrm:latest

# Your own steps, for example:
ADD --chown=$APP_USER:$APP_GROUP ./espocrm/ /var/www/html/

Adding PHP extensions, hooks, autorun scripts and cron jobs are covered in shinsenter/php⁠.

⁠Image tags and platforms

• All tags and platforms: Docker Hub⁠. Debian and Alpine variants are available.
• Since 2026-10-25, linux/386, linux/arm/v7, linux/ppc64le and linux/s390x are no longer built. Older tags keep them until they are rebuilt.
• Images are rebuilt when PHP, the base OS or Composer publish an update, so a tag can change over time. For production, pin your own copy:

docker pull shinsenter/espocrm:latest
docker tag  shinsenter/espocrm:latest your-repo/espocrm:stable
docker push your-repo/espocrm:stable

⁠Support the project

Keeping these images rebuilt for every PHP release takes ongoing work. If they save you time, you can help keep them going:

• ☕ Donate via PayPal⁠
• 💖 Sponsor on GitHub⁠

Reporting a bug, sharing the project or giving it a star on GitHub⁠ also helps.

⁠Issues and license

• Questions and bugs: GitHub issues⁠.
• Licensed under the GNU General Public License v3.0⁠. If you reuse ideas from this project, please give credit.

From Vietnam 🇻🇳 with love.