Add EspoCRM docs

[tmachyshyn]

This is the documentation for EspoCRM image, docker-library/official-images#7603

[tmachyshyn]

@LaurentGoderre thanks for your recommendations. That's all fixed.

[tmachyshyn]

@LaurentGoderre I fixed some ymlfmt & markdownfmt validation errors in the last commit.
If any other changes are needed please let me know.

[tianon]

(force push: just a rebase to kick CI and see where we're at status-wise)

[tianon]

There might be other things you want to update here (it's probably been a minute since you looked at it 😄) but here are a few notes I saw while reviewing it:

---

The docker run examples use --link, which has been deprecated. The current pattern across these docs is --network some-network (see e.g. drupal, joomla):

$ docker run --name mysql --network some-network -e MYSQL_ROOT_PASSWORD=password -d mysql:8
$ docker run --name some-%%REPO%% --network some-network -d %%IMAGE%%

$ docker run --name some-%%REPO%% --network some-network -p 8080:80 -d %%IMAGE%%

$ docker run --name some-%%REPO%% --network some-network -e ESPOCRM_SITE_URL=http://172.20.0.100:8080 -p 8080:80 -d %%IMAGE%%

(The container name mysql matches the default ESPOCRM_DATABASE_HOST, so no extra env var is needed.)

---

In stack.yml:

ESPOCRM_ADMIN_PASSWORD: password

And in the prose examples:

access it via http://localhost:8080 with credentials "admin" and "password"

The image does the right thing -- it emits an explicit startup warning when default credentials are detected. But the docs present them as the happy path with no caveat. The stack.yml value should use a placeholder like your_admin_password, and the prose examples should note that those credentials need to be changed before any real use.

---

ESPOCRM_DATABASE_PORT is a supported install-time option (it's in the image's defaults) but doesn't appear in the environment variables section.

---

Two small prose fixes:

• "This image requires to run MySQL server" → "This image requires a running MySQL server"
• "These environment variables are using to define" → "are used to define"

[tianon]

This file should reference only images from DOI 👀

What's the purpose of each espocrm container having the same exact health check? Does it actually check the running service in some way?

Suggested change

	image: espocrm/espocrm:latest
	container_name: espocrm
	environment:
	ESPOCRM_DATABASE_HOST: espocrm-db
	ESPOCRM_DATABASE_USER: espocrm
	ESPOCRM_DATABASE_PASSWORD: your_database_password
	ESPOCRM_ADMIN_USERNAME: admin
	ESPOCRM_ADMIN_PASSWORD: your_admin_password
	ESPOCRM_SITE_URL: "http://localhost:8080"
	volumes:
	- espocrm-data:/var/www/html/data
	- espocrm-custom:/var/www/html/custom
	- espocrm-custom-client:/var/www/html/client/custom
	restart: unless-stopped
	depends_on:
	espocrm-db:
	condition: service_healthy
	healthcheck:
	test: ["CMD", "bin/command", "app-check"]
	start_period: 20s
	interval: 60s
	timeout: 20s
	retries: 3
	ports:
	- 8080:80
	espocrm-daemon:
	image: espocrm/espocrm:latest
	container_name: espocrm-daemon
	volumes_from:
	- espocrm
	restart: unless-stopped
	entrypoint: docker-daemon.sh
	depends_on:
	espocrm:
	condition: service_healthy
	healthcheck:
	test: ["CMD", "bin/command", "app-check"]
	start_period: 20s
	interval: 180s
	timeout: 20s
	retries: 3
	espocrm-websocket:
	image: espocrm/espocrm:latest
	image: espocrm:latest
	container_name: espocrm
	environment:
	ESPOCRM_DATABASE_HOST: espocrm-db
	ESPOCRM_DATABASE_USER: espocrm
	ESPOCRM_DATABASE_PASSWORD: your_database_password
	ESPOCRM_ADMIN_USERNAME: admin
	ESPOCRM_ADMIN_PASSWORD: your_admin_password
	ESPOCRM_SITE_URL: "http://localhost:8080"
	volumes:
	- espocrm-data:/var/www/html/data
	- espocrm-custom:/var/www/html/custom
	- espocrm-custom-client:/var/www/html/client/custom
	restart: unless-stopped
	depends_on:
	espocrm-db:
	condition: service_healthy
	healthcheck:
	test: ["CMD", "bin/command", "app-check"]
	start_period: 20s
	interval: 60s
	timeout: 20s
	retries: 3
	ports:
	- 8080:80
	espocrm-daemon:
	image: espocrm:latest
	container_name: espocrm-daemon
	volumes_from:
	- espocrm
	restart: unless-stopped
	entrypoint: docker-daemon.sh
	depends_on:
	espocrm:
	condition: service_healthy
	healthcheck:
	test: ["CMD", "bin/command", "app-check"]
	start_period: 20s
	interval: 180s
	timeout: 20s
	retries: 3
	espocrm-websocket:
	image: espocrm:latest