Masa CMS test environments

These are test environments for Masa CMS.

Quick Start with Makefile

The easiest way to start a test environment is using the Makefile:

Requirements

• GIT
• Docker
• Docker compose
• Commandbox CLI

Setup

• Clone Masa CMS into this project: git clone git@github.com:MasaCMS/MasaCMS.git masacms

Start environment

Option 1: Using Makefile interactively (Recommended)

Simply run make to get an interactive menu:

$ make
╔════════════════════════════════════════╗
║  MasaCMS Test Environment Setup        ║
╔════════════════════════════════════════╗

Select Database:
  1) MySQL
  2) MariaDB
  3) PostgreSQL
  4) MSSQL

Enter database choice (1-4): 1

Select ColdFusion Engine:
  1) Lucee
  2) BoxLang
  3) Adobe ColdFusion

Enter engine choice (1-3): 3

Select Adobe ColdFusion Version:
  1) ColdFusion 2021
  2) ColdFusion 2023
  3) ColdFusion 2025
  4) Latest

Enter version choice (1-4): 3

Starting mysql database and Adobe ColdFusion cf25...
✓ MySQL is running on port 3306
✓ Adobe ColdFusion cf25 is running on http://localhost:18081

Note: When selecting Adobe ColdFusion, you'll be prompted to choose a version. This does not apply to Lucee or BoxLang engines.

Option 2: Using Makefile Direct Commands

Starting Environments

Start a specific database + CF engine combination:

# Lucee combinations
make lucee-mysql
make lucee-mariadb
make lucee-postgres
make lucee-mssql

# BoxLang combinations
make boxlang-mysql
make boxlang-mariadb
make boxlang-postgres
make boxlang-mssql

# Adobe ColdFusion combinations
make adobe-mysql
make adobe-mariadb
make adobe-postgres
make adobe-mssql

# Adobe with specific version
make adobe-mysql CF_VERSION=cf21      # ColdFusion 2021
make adobe-mysql CF_VERSION=cf23      # ColdFusion 2023 (default)
make adobe-mysql CF_VERSION=cf25      # ColdFusion 2025
make adobe-mysql CF_VERSION=latest    # Latest version

Starting Database Only

make mysql      # Port 3306
make mariadb    # Port 3307
make postgres   # Port 5432
make mssql      # Port 1433

Stopping and Cleaning

# Stop all running containers (keeps containers)
make stop

# Stop and remove all containers (keeps volumes)
make down

# Remove everything: containers, volumes, and network
make clean

Examples

# Start MySQL and Lucee
make lucee-mysql
# Visit http://localhost:18181

# Start MariaDB and Adobe ColdFusion 2025
make adobe-mariadb CF_VERSION=cf25
# Visit http://localhost:18080

# Start MySQL and Adobe ColdFusion 2021
make adobe-mysql CF_VERSION=cf21
# Visit http://localhost:18081

# Start PostgreSQL and BoxLang
make boxlang-postgres
# Visit http://localhost:18282

# Start MariaDB and Adobe ColdFusion (default: 2023)
make adobe-mariadb
# Visit http://localhost:18080

# When done, stop everything
make down

Option 3: Manual Docker Compose

• Open a terminal
• Navigate to the folder of the desired database (for example: /mariadb/)
• Start the database: docker compose up -d
• Navigate to the folder of the desired cfml engine (for example: /lucee/mariadb/)
• Start the cfml engine: docker compose up -d
• Open http://localhost:{portnumber} in the browser

Port Reference

Lucee Ports

• MySQL: 18181
• MariaDB: 18180
• PostgreSQL: 18182
• MSSQL: 18183

BoxLang Ports

• MySQL: 18281
• MariaDB: 18280
• PostgreSQL: 18282
• MSSQL: 18283

Adobe ColdFusion Ports

• MySQL: 18081
• MariaDB: 18080
• PostgreSQL: 18082
• MSSQL: 18083

Database Ports

• MySQL: 3306
• MariaDB: 3307
• PostgreSQL: 5432
• MSSQL: 1433

Troubleshooting

If you encounter issues:

1. Port conflicts: Check if ports are already in use on unix-based systems:

   lsof -i :3306  # Check MySQL port
   lsof -i :18181 # Check Lucee port

   on windows-based systems (as Administrator):

   netstat -ab

   this shows a list of applications and ports used

2. Network issues: Recreate the network

   make clean
   make network

3. View logs: Use docker compose logs

   cd lucee/mysql
   docker compose logs -f

4. Full cleanup: Remove everything and start fresh

   make clean
   make lucee-mysql  # Or your preferred combination

Run test suite

• Install testbox in Masa CMS: cd masacms && box install
• Start the desired environment
• Open http://localhost/core/tests/runner.cfm in the browser

Configuration details

Masa CMS

• admin username: admin
• admin password: admin
• reload key: appreload

Adobe ColdFusion

• administrator url: http://localhost/CFIDE/administrator/index.cfm
• administrator password: password

Lucee

• administrator url: http://localhost/lucee/admin/server.cfm
• administrator password: password

Database

MariaDB

• host: localhost:3307
• user: root
• password: rootpassword

MySQL

• host: localhost:3306
• user: root
• password: rootpassword

PostgreSQL

• host: localhost:5432
• user: root
• password: rootpassword

MSSQL

• host: localhost:1433
• user: sa
• password: sup3r_passw0rd