Installation

Getting started with BoxLang is easy! Choose your path wisely!

PLEASE NOTE THAT WE ARE STILL IN OPEN BETA. ANYTHING CAN CHANGE

Requirements

• JDK 21+

BoxLang is currently compiling Java source on the fly for debugging purposes, so it requires a JDK, not a JRE, to run! Once we go stable, JRE will be the requirement.

Mac

*Unix

Leverage your system‘s package manager to install the needed requirements.

APT

Yum

Windows

Powershell Script

Quick Installer

To get started quickly with BoxLang, use our BoxLang Quick Installer for Mac/Linux/*Nix/Windows

Bash / ZSH

SH

Windows PowerShell

If your system requires admin privileges (Like Chromebooks), make sure you use sudo or make sure the /usr/local folder is yours as the owner.

The quick installer requires the following:

• JDK21+

• Permission to copy files to /usr/local/bin and /usr/local/lib

The quick installer will install the OS binary and the MiniServer in the above directories. It will also install the following scripts for you.

• install-boxlang - The quick installer so you can reuse it to upgrade your installations

• install-bx-module - A module installer. Just pass in the slug of the module and watch it install

• install-bx-modules - A way to install multiple modules asynchronously. Just pass a space delimited list

Upgrading Your Install

The install-boxlang script will allow you to easily upgrade your OS install as well. If you call it with no arguments, then it will install the latest release and override the local install. You can also pass a specific version to install as the second argument.

You can get the version of the current BoxLang Runtime by running boxlang --version

REPL

Just run boxlang and you are ready to rock in our REPL:

Installing Modules

Binaries

The quick installer is the best and easiest way to get installed on Mac or *Nix. However, below, you can find a collection of all our installers and binaries for running BoxLang and each Runtime.

Please note that the binaries here are the latest beta builds, not the bleeding edge builds.

Operating System Binaries

Here, you can find the installers and binaries for all Operating Systems:

MiniServer Binaries

The BoxLang MiniServer includes the BoxLang OS runtime with the addition of our super fast and lightweight web server.

AWS Lambda Binaries

CommandBox BoxLang Server

Servlet EE Binaries

This is the servlet edition of BoxLang that you can deploy on any servlet container (Jetty, Tomcat, JBoss, etc)

Docker

BoxLang IDE

The BoxLang IDE is a collection of modules for VSCode. You can find it here:

Core Modules

We recommend you use CommandBox, Our CLI and Package Manager, to interact, install, and work with any package in BoxLang.

BoxLang+, ++ Modules

Please note that these modules are still under development; we will publish their status as we complete them.