Skip to main content

Featured work

b-docker

Bitrix Docker tooling that finally feels modern — repeatable PHP 8.x, MariaDB, push, sphinx, agents behind a single Makefile.

  • Docker Compose
  • PHP 8.x
  • Bitrix D7
  • Make

The problem

Bitrix dev environments traditionally feel like 2008. b-docker is what I wish I’d had ten years ago: a clean multi-stage Docker Compose stack with everything Bitrix expects (PHP 8.x, MariaDB, push, sphinx, scheduled agents) and nothing it doesn’t.

Architecture

  • Single Makefile orchestrates up, down, nuke, logs, psql, sh, xdebug-on/off.
  • Services: php-fpm, nginx, mariadb, push, sphinx, agents, mailhog.
  • Volumes split between code (bind-mounted, read-write) and DB (named volume, persistent across nuke).
  • Xdebug 3 is a profile, not a config — turn it on per-shell when needed.

Implementation highlights

  • Cold-start to logged-in admin in < 2 minutes on a typical laptop.
  • Stateless: make nuke rebuilds everything except the database volume. Your dump survives.
  • IDE-ready: .env.example ships with VS Code + PhpStorm step-debug profiles documented.
  • Sphinx is wired correctly — most Bitrix Docker setups skip this and then bitrix:catalog.search fails for 18 months until someone notices.

Results

Kept dozens of small Bitrix shops productive without selling their souls to legacy XAMPP. 4★ and counting. Friends of the friends keep asking for it.

Lessons

  • A great dev env is one you stop thinking about.
  • make plus Compose plus a one-page README beats a polished dashboard you have to learn.