Plus Core

Core subscription bootstrap module enabling licensing utilities, and shared helpers for premium BoxLang+ modules.

The bx-plus module is the enterprise licensing and feature management module that unlocks the full potential of BoxLang+ and BoxLang++ subscription plans. This module provides the essential licensing infrastructure, validation, and activation services that enable access to premium enterprise features and functionality across all BoxLang+ and BoxLang++ modules.

What This Module Enables

The bx-plus module serves as the foundation for enterprise BoxLang subscriptions by providing:

• License Activation & Validation - Secure JWT-based license management with automatic token refresh

• Trial Mode Management - 60-day trial period tracking for evaluation purposes

• Enterprise Feature Gating - Controls access to premium modules and functionality based on subscription level

• Subscription Status Monitoring - Real-time validation of license status and subscription benefits

• Multi-Environment Support - License binding and validation across development, staging, and production environments

Premium Features Unlocked

With an active BoxLang+ or BoxLang++ subscription and this module, you gain access to enterprise-grade capabilities such as:

• Advanced Caching & NoSQL - Redis, Couchbase, MongoDB, and other distributed caching solutions

• Enhanced Communication Services - Enterprise messaging and notification systems ( Redis and Couchbase modules )

• Premium CommandBox Features - Multi-site management, advanced deployment tools, and professional server features

• Priority Support & SLAs - Business-grade support with guaranteed response times

• Professional Tooling - Enhanced development and debugging tools for enterprise workflows

• Custom Language Parsers - Support for additional language syntaxes and compatibility modules

📦 Installation

Via CommandBox

box install bx-plus

Via BoxLang

install-bx-module bx-plus

For a complete list of features and benefits, visit the BoxLang Plans page.

Getting Started

License Activation

To activate your BoxLang+ or BoxLang++ subscription and enable enterprise features you can do so, programmatically, using the built in functions or use the CLI ( see below ) for building hardened images and deployments:

// Activate your license using the provided BIF
boxlangLicenseActivate(
    email = "[email protected]",
    licenseKey = "your-license-key",
    serverType = "server" // or "cloud"
);

Refreshing License Token

To refresh your license token ( Note: the refresh will automatically be attempted on the day of the previous token expiration):

// Refresh the current license token
refreshResult = boxlangLicenseRefresh();
writeOutput( "License refreshed successfully" );
writeOutput( "Updated license info: " & serializeJSON( refreshResult ) );

This function will attempt to refresh your existing license token using the stored refresh token. It's useful for:

• Extending license validity before expiration

• Updating license information after subscription changes

• Ensuring continued access to enterprise features

Checking License Status

You can programmatically check your license status and available features:

// Get current license information
licenseInfo = boxlangLicenseInfo();
writeOutput( "License Status: " & licenseInfo.status );
writeOutput( "Trial Mode: " & licenseInfo.isTrialMode );

CLI Methods

In addition to the built-in functions (BIFs), the bx-plus module provides command-line interface methods for license management.

Available CLI Commands

activate

Activates your BoxLang+ or BoxLang++ license from the command line.

boxlang module:plus activate --email [email protected] --licenseKey your-license-key --serverType server

Required Options:

• --email - The email address associated with your license

• --licenseKey - Your BoxLang+ or BoxLang++ license key

Optional Options:

• --serverType - The type of server deployment (default: "Production")

refresh

Refreshes the current license token to ensure continued access to enterprise features.

boxlang module:plus refresh

This command will attempt to refresh your existing license token and display the updated license information.

info

Displays detailed information about your current license status and subscription.

boxlang module:plus info

Returns information including:

• License status (active, expired, trial, etc.)

• Subscription type (BoxLang+, BoxLang++, trial)

• License expiration date

• Available features and modules

help

Shows usage information and available commands.

boxlang module:plus help

CommandBox CLI Usage

If you are using CommandBox, and wish to activate a server, without installing the core BoxLang binary, you can also use the CLI activation commands. This is especially useful in activating licenses when building Docker images for deployment.

box boxlang cli module:bx-plus activate --email=$BX_LICENSE_EMAIL --licenseKey=$BX_LICENSE_KEY --serverType=Development|Staging|Production

All of the commands listed above in the CLI section are available by simply using boxlang cli in place of just boxlang .

For example, to build and register a licensed Docker image

FROM ortussolutions/commandbox

ARG BX_LICENSE_EMAIL
ARG BX_LICENSE_KEY
ARG BX_SERVER_TYPE=Production

ENV BOX_SERVER_APP_CFENGINE=boxlang

RUN ${BUILD_DIR}/util/warmup-server.sh

RUN box boxlang cli module:bx-plus activate --email=$BX_LICENSE_EMAIL --licenseKey=$BX_LICENSE_KEY --serverType=$BX_SERVER_TYPE

Enterprise Support

This module is part of the BoxLang+ and BoxLang++ enterprise subscription offerings. For enterprise support, license questions, or to purchase a subscription:

• Visit: BoxLang Plans

• Email: [email protected]

• Phone: [phone]

---

Next: Explore data caching with the bx-redis module.