Web development environment

Clone Zabbix repository to directory zabbix in user home directory. As persistent storage of database containers ./docker-volume directory is used. Web server and PHP log files are stored in directory zabbix/log in user home directory.
To define custom directories copy .env.example file to .env and make required changes to fit your needs.

Start development environment

To start required environment use --profile options from table below.

Profile key	Hostname	Service	Image
apache		web server apache	httpd:alpine
nginx		web server nginx	nginx:alpine
phpfpm56	php	php 5.6	Dockerfile/php5.6.Dockerfile
phpfpm74	php	php 7.4	Dockerfile/php7.4.Dockerfile
phpfpm80	php	php 8.0	Dockerfile/php8.0.Dockerfile
phpfpm83	php	php 8.3	Dockerfile/php8.3.Dockerfile
mariadb	db	database mariadb	mariadb:lts
mysql	db	database mysql 8.2	mysql:8.2
mysql-legacy	db	database mysql 5.7	mysql:5.7
postgres	db	(TBD)
saml	saml	(TBD)
ldap	ldap	(TBD)

Example: start nginx webserver with php 8.3 and mysql 8.2

docker-compose --profile nginx --profile phpfpm83 --profile mysql up
docker-compose --profile apache --profile phpfpm83 --profile mysql up

XDebug

To enable xdebug add pathMappings to VSC configuration launch.json file, example:

"configurations": [
    {
        "name": "Listen for Xdebug",
        "type": "php",
        "request": "launch",
        "port": 9003,
        "pathMappings": {
            "/var/www/html": "${workspaceRoot}/../"
        }
    }
]

Legacy frontend version support

For Zabbix version up to 4.4 PHP 5.6 and mysql 5.7 are required. To start legacy dev environment run:

docker-compose --profile nginx --profile phpfpm56 --profile mysql-legacy up

Docker

brew install docker colima
brew install docker-compose
colima start --memory 12  #  Start Colima VM with 12 GB of RAM for use by containers