Blog

BoxLang Runtime for AWS Lambda!

Maria Jose Herrera June 05, 2024

Spread the word

Maria Jose Herrera

June 05, 2024

Spread the word


Share your thoughts

BoxLang: Announcing Lambda for the Win!

We are excited to introduce the latest addition to our serverless computing toolkit: the BoxLang Runtime for AWS Lambda! This new release enables you to seamlessly run BoxLang functions in AWS Lambda, providing a powerful and flexible way to develop serverless applications.

Please note. We are still in Open Beta, Anything can change.

Learn More

What is AWS Lambda?

AWS Lambda is a serverless computing service from Amazon Web Services (AWS) that lets you run code without provisioning or managing servers. It automatically scales applications by running code that responds to events and allocating compute resources as needed, allowing developers to focus on writing code rather than managing infrastructure. Learn more about AWS Lambda

AWS Lambda

BoxLang Runtime for AWS Lambda

Our new BoxLang AWS Runtime allows you to execute Lambda.bx functions within the AWS Lambda ecosystem. We've also provided a handy template to help you get started with serverless computing using BoxLang.

Key Features

  • Default Lambda Handler: The runtime includes a pre-configured handler that accepts JSON inputs as a BoxLang Struct and outputs either simple or complex objects. The default handler is ortus.boxlang.runtime.aws.LambdaRunner::handleRequest.

Handler Code

  • Environment Variables: Customize your Lambda function with environment variables such as BOXLANG_LAMBDA_CLASS, BOXLANG_LAMBDA_DEBUGMODE, and BOXLANG_LAMBDA_CONFIG.

  • Default Template: Our default template is a Gradle project designed to streamline your development process. It includes everything from VSCode tasks to AWS Lambda utilities.

Review Template

Getting Started

  1. Download the Runtime:

    shellCopy code
    ./gradlew downloadBoxLang
    
    
  2. Run Tests:

    shellCopy code
    ./gradlew test
    
    
  3. Build the Project:

    shellCopy code
    ./gradlew build
    
    

Learn More

Example Lambda Function

Here's a simple example of a Lambda.bx function:

boxlangCopy code
class{
    function run( event, context, response ){
        response.body = {
            "error": false,
            "messages": [],
            "data": "====> Incoming event " & event.toString()
        };
        response.statusCode = 200;
    }
}

Get Started

Deploying to AWS

  1. Create a Function: Log in to the Lambda Console and click on "Create function".
  2. Configure the Function: Add a function name, choose Java 21 as the runtime, and select x86_64 as the architecture.
  3. Upload Code: Upload your code as a zip/jar or from an S3 location.
  4. Set the Handler: Use ortus.boxlang.runtime.aws.LambdaRunner::handleRequest as the handler.
  5. Test Your Function: Use the Test tab to create an event and test your function.

Deploy to AWS

Contribute and Explore

The source code for the AWS Runtime is available HERE. We welcome contributions, testing, and documentation improvements.

AWS Runtime

Get started with the BoxLang Runtime for AWS Lambda today and unlock the potential of serverless computing! Visit our GitHub repository for more details and to get started.

Happy coding!

Add Your Comment

Recent Entries

12 Days of BoxLang - Day 4: TestBox

12 Days of BoxLang - Day 4: TestBox

Today we’re celebrating one of the most exciting new additions to the BoxLang ecosystem:

the TestBox BoxLang CLI Runner — a fast, native way to run your TestBox tests directly through the BoxLang Runtime. ⚡

No server required. No CommandBox needed. Just pure, ultra-fast BoxLang-powered testing from the command lineon Windows, Mac, and Linux.

If you’re building modern applications with BoxLang — web apps, CLIs, serverless functions, Android apps, or OS-level utilities — this new feature gives you a unified, flexible testing workflow you can run anywhere.

Victor Campos
Victor Campos
December 13, 2025
12 days of BoxLang - Day 3: SocketBox!

12 days of BoxLang - Day 3: SocketBox!

As BoxLang continues evolving into a modern, high-performance, JVM-based runtime, real-time communication becomes essential for the applications we all want to build: dashboards, collaboration tools, notifications, live feeds, multiplayer features, and more.

That’s where SocketBox steps in — the WebSocket upgrade listener built to work seamlessly with CommandBox and the BoxLang MiniServer. ⚡

Today, for Day 3, we’re highlighting how SocketBox supercharges BoxLang development by giving you fast, flexible, and framework-agnostic WebSocket capabilities.

Maria Jose Herrera
Maria Jose Herrera
December 12, 2025
12 Days of BoxLang - Day 2: CommandBox

12 Days of BoxLang - Day 2: CommandBox

BoxLang + CommandBox: The Enterprise Engine Behind Your Deployments

For Day 2 of our 12 Days of Christmas series, we’re diving into one of the most powerful parts of the BoxLang ecosystem: CommandBox the defacto enterprise servlet deployment platform for BoxLang.

If BoxLang is the language powering your applications, CommandBox is the engine room behind it all. ⚙️

Victor Campos
Victor Campos
December 11, 2025