Version 1.5.0

Changed

• Bump BoxLang version to 1.5.0+41

• Systemd daemon for manage BoxLang MiniServer process is now boxlang-site

Added

• startBoxLangSite.sh script is now on charge to start|stop BoxLang MiniServer process through boxlang-site Systemd daemon

  • It checks if there is custom site under /web/boxlang-site/wwwroot placed by users and if there is a server.json file, if not start default ColdBox Application under /web/boxlang-site/default

Version 1.4.1

Removed

• /web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot

Version 1.4.0

Added

• Bump BoxLang version to 1.4.0

Version 1.3.0

Added

• BoxLang update to 1.3.0

Version 1.1.0

Added

• BoxLang MiniServer now support URL Rewrites

Removed

• Nginx Reverse Proxy

Version 0.3.0

• Initial Release

This AMI image will create a running BoxLang server with CFML compatibility module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. The first step is to have an AWS account. If you do not have one go to this URL to learn how to create an [AWS account.]( https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/)

Choose the BoxLang MiniServer for Ubuntu AWS AMI. Go to this URL and do a search for Ortus at the top of the screen https://aws.amazon.com/marketplace/ and look for "Ortus solutions, corp"

Click the View purchase options to subscribe button

Configuration options for subscription. In this section you can choose to add options to your contract, if not, You can click on "Continue configuration" button.

You can configure your Ortus Soluction software version or region, if not, just click on "Continue to Launch" button.

In "Launch" section you can choose method to launch, for this case, We're going to use EC2 method.

This will take you to the "Choose an Instance Type." The default instance and AWS free tier selected is t2.medium. Unless you need more resources keep it at this. If You desire or You do not have Key pair, You can generate new ones in "Key pair (login)" section. On the "Network settings" section under "Firewall (Security groups)". We need to make a couple of changes. First is to go to the source column and select My IP so that SSH and RDP will only be enabled for your IP address (VERY IMPORTANT). Next allow HTTP and HTTPS. You can edit VPC, Subnet and Public IP configuration. On "Configure Storage" section. If you want to persist your files, then add a volume. If you do not need to persist the files, keep the defaults.

Select your running instance. This will open some tabs at the bottom of the page. Select the "Description" tab. Look to the right on the description tab and look for "Public DNS (IPv4)." To the right of this text is the DNS name. Copy that name and paste it in a browser. It should look something like this ec2-{public_dns}.compute-1.amazonaws.com.

Paste that URL in a browser and you should see the default ColdBox site.

SSH to your instance with following command ssh -i "/path/to/your/private-key" ubuntu@ec2-{public\_dns}.compute-1.amazonaws.com and create a handler.

Elevate to root user, change your current directory to /web/coldbox-site/wwwroot and run box command to launch CommandBox CLI

Now, you can update system dependencies typing update --system. create a new handler for testing using coldbox create handler type=index name=helloFromBoxLangCloudServer command

ENJOY YOUR CLOUD SERVER!

Create an EC2 instances from an Ortus BoxLang engine (Ubuntu Server 24.04 LTS) AMI (Amazon Machine Image). We have created several based Ubuntu based images.

Version 2.0.1_5.4.6.9

• Security update for Apache Tomcat Server CVE-2025-24813

Version 1.0.0_5.2.3.9

• Initial Release

Version 1.4.0

Added

• Bump BoxLang version to 1.4.0

Removed

• /web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot

Version 1.3.0

Added

• BoxLang MiniServer now support URL Rewrites

Removed

• Nginx Reverse Proxy for URL Rewrites

Create an EC2 instances from an Ortus BoxLang engine (Ubuntu Server 24.04 LTS) AMI (Amazon Machine Image). We have created several based Ubuntu based images.

Software and tools installed matrix

On every Ubuntu based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:

Due these Cloud Servers are Ubuntu 24.04 LTS based, you can follow this to know more about base software running.

Environment variables

Default site

For every Linux based BoxLang Cloud Server a Systemd daemon is used to get up and running a Web Server on well know HTTP port 80/TCP. Depending of the server flavor this can be started using BoxLang MiniServer or CommandBox. If you want to start a custom site or application, you can update this daemon service if need it, or just only place your custom site or application under /web/boxlang-site/wwwroot directory.

This page will walk you through connecting to your new server using the popular free software program WinSCP. I have a script for you to download on step 11 "Managing your web site" page.

WinSCP let's get going

• Run WinSCP

• In the Login dialog, click on the “New Session” button

• Then click the "Advanced..." button

• From this dialog select the SSH Authentication browse button to the right of the input box.

• You will be given a file explorer box. Then select your pem file that you downloaded when you created your ec2. The prompt with look like this click ok.

• Click the ok button

• You have connected

This AMI image will create a running BoxLang server with CFML compatibility module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. The first step is to have an AWS account. If you do not have one go to this URL to learn how to create an [AWS account.]( )

Choose the BoxLang with CommandBox for Ubuntu AWS AMI. Go to this URL and do a search for Ortus at the top of the screen and look for "Ortus solutions, corp"

Click the View purchase options to subscribe button

Configuration options for subscription. In this section you can choose to add options to your contract, if not, You can click on "Continue configuration" button.

You can configure your Ortus Soluction software version or region, if not, just click on "Continue to Launch" button.

Now that you have a site running in the cloud you will want to customize it. Remember that SSH pem file you downloaded. That is going to allow you to go on the server and edit files. If you are on a windows platform like me. Here are some tools I strongly suggest that you get locally.

1. CommandBox. This tool will allow you to make files and remove them locally. If you so decide that you want to edit and add files directly on the EC2 instance this can be done using the default instance of CommandBox on the server.

2. VSCode the editor of choice, and the reason I say that is because it has so many useful extensions.

This page will walk you through connecting to your new server using the popular free software program WinSCP. I have a script for you to download on step 11 "Managing your web site" page. We will also take a look at an exciting VSCode extension called Remote Development. It allows you to SSH directly to the EC2 instance and map the remote folder in your local VSCode IDE.

Version 1.0.0_5.3.7.47

• Initial Release

This AMI image will create a running Lucee site for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. The first step is to have an AWS account. If you do not have one go to this URL to learn how to create an [AWS account.]( )

• Choose the Lucee CFML Server (Ubuntu+Nginx+Tomcat) AWS AMI. Go to this URL and do a search for Ortus at the top of the screen and look for "Ortus solutions, corp"

• Click the View purchase options to subscribe button

You can install the VSCode Remote Development Extension by visiting the URL or opening VSCode and clicking the extension load button in the IDE and searching for "Remote Development."

Steps to connect to ec2.

• Click in the green box in the bottom left corner of VSCode. This will open a select box already populated with different Remote Development choices. You want to select Remote-SSH: Open SSH Configuration File...

• If you have not created a configuration file you will have this option. Remote-SSH: Add New SSH Host... Select that instead.

• Your configuration file should look something like this after you fill it out.

• Having done that it is time to connect to your ec2 instance. Let's click the green button in the lower left corner. The same one we used to open the configuration file. Let's select "Remote-SSH: Connect Current Window to Host..."

• If all works you should have a VSCode screen that looks like the one below. If it does not work you can do what I did, that is to downgrade to VSCode 1.36.1. You can do that with Chocolatey.

Default Sites

The sites you are given are http://website1.com and http://website2.com. You can display these in your Windows Host file at C:\Windows\System32\drivers\etc\hosts. To see the site you add the entries like this below.

Open a browser with those URLS and you will see your site with the default ColdBox frameworks. In order to set different site names you will want to edit website1.conf and website2.conf files open a shell and navigate to:

This AMI image will create a running CommandBox Lucee site for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. The first step is to have an AWS account. If you do not have one go to this URL to learn how to create an [AWS account.]( https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/)

• Choose the AWS AMI. Go to this URL and do a search for Ortus at the top of the screen https://aws.amazon.com/marketplace/

• Click the continue to subscribe button

• Click the accept terms button

• Next go to this page and click launch new instance

• This will take you to the "Choose an Instance Type." The default instance and AWS free tier selected is t3.micro. Unless you need more resources keep it at this. Go to the bottom of the screen and select Next:Configure Instance Details.

• You are on the "Configure Instance Details" page and keep the defaults. Go to bottom of the page and click "Next: Add Storage" button.

• You are now on the "Add Storage" page. Keep the defaults and click the button at the bottom right "Next: Add Tags."

• You are now on the "Add Tags" page. Let's add a tag. Click the add Tag. They should be Key=Name and Value=Ortus Commandbox CFML engine - multisite (Ubuntu Server 18.04 LTS). Next go to the bottom of the page and click the button that says "Next: Configure Security Group."

• You are on the "Configure Security Group" page. We need to make a couple of changes before leaving this page. First is to go to the source column and select MyIP so that ssh will only be enabled for your IP address (VERY IMPORTANT).

• Next click the "Add Rule" button and under the type column select http and leave port 80 selected. Go to the bottom right of the page and select and click the "Review and Launch" button.

• You are on the "Review Launch Instance" page. Review it and once you are okay click the "Launch" bottom on the bottom right of page.

• This opens a module window that is prompting you to suggesting an existing key pair or create a new open. If you do not know what this means I suggest you create a new key pair and put it in a folder that you have access to. If all went well you will see a green colored headline that says "Your instances are now launching."

• You are on the "Launch Status" page. Go to the bottom right and click the button labeled "View Instances."

• Select your running instance. This will open some tabs at the bottom of the page. Select the "Description" tab. Look to the right on the description tab and look for "Public DNS (IPv4)." To the right of this text is the dns name. Copy that name and paste it in a browser. It should look something like this

• ec2-{public_dns}.compute-1.amazonaws.com

• Paste that URL in a browser and you should see the default ColdBox site.

Enjoy your server!

Now that you have a site running in the cloud you will want to customize it. Remember that SSH pem file you downloaded. That is going to allow you to go on the server and edit files. If you are on a windows, Mac or Linux platform, here are some tools I strongly suggest that you get locally. The instructions below are for Windows but all of these tools are available for all 3 platforms.

1. CommandBox. This tool will allow you to make files and remove them locally. If you so decide that you want to edit and add files directly on the EC2 instance this can be done using the default instance of CommandBox on the server. https://commandbox.ortusbooks.com/

2. VSCode the editor of choice, and the reason I say that is because it has so many useful extensions. https://code.visualstudio.com/download

3. WinSCP the default file manager tool for Windows.

If you are using the Windows Package Manager you can download all of these from there.

Here is a script to download them in Powershell. Save the script as anything.ps1. Remember where you saved it. With PowerShell, you must make sure is not Restricted. We suggest using Bypass to bypass the policy to get things installed or AllSigned for quite a bit more security.

• Run Get-ExecutionPolicy. If it returns Restricted, then run Set-ExecutionPolicy AllSigned or Set-ExecutionPolicy Bypass -Scope Process.

Go to the right corner of the dialog box below and copy this script and save it naming it whatever you like as long as the extension ends as *.ps1

If your scripts successfully installed you should see a new desktop icon for VSCode. If you open a shell ( CMD, Powershell, git bash ) and type box you should see that CommandBox is installed.