CiviCRM Docker

Local CiviCRM Standalone development environment using Docker.

Quick Start

docker compose up

CiviCRM will be available at http://localhost:8000

Login

• Username: admin
• Password: civicrm

Fresh Start

To wipe all data and start over:

docker compose down -v
docker compose up

Configuration

Environment variables in docker-compose.yml:

Variable	Default	Description
CIVICRM_DB_HOST	mysql	Database host
CIVICRM_DB_NAME	civicrm	Database name
CIVICRM_DB_USER	civicrm	Database user
CIVICRM_DB_PASS	civicrm	Database password
CIVICRM_UF_BASEURL	http://localhost:8000/	Public base URL
CIVICRM_ADMIN_PASS	civicrm	Admin user password

What the Entrypoint Does

On first boot (when no civicrm.settings.php exists), entrypoint.sh:

1. Creates required directories (private/cache, private/tmp) with correct permissions
2. Runs cv core:install to initialize the database and generate the settings file
3. Patches all URLs in the settings file to match CIVICRM_UF_BASEURL
4. Sets the admin password from CIVICRM_ADMIN_PASS