Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The source code for this book is hosted in GitHub: https://github.com/ortus-docs/cloud-servers. You can freely contribute to it and submit pull requests. The contents of this book is copyright by Ortus Solutions, Corp and cannot be altered or reproduced without author's consent. All content is provided "As-Is" and can be freely distributed.
The majority of code examples in this book are done in cfscript.
The majority of code generation and running of examples are done via CommandBox: The ColdFusion (CFML) CLI, Package Manager, REPL - http://www.ortussolutions.com/products/commandbox
All ColdFusion examples designed to run on the open source Lucee Platform or Adobe ColdFusion 2016+
ColdFusion, and Adobe are registered trademarks and copyrights of Adobe Systems, Inc.
The information in this book is distributed “as is”, without warranty. The author and Ortus Solutions, Corp shall not have any liability to any person or entity with respect to loss or damage caused or alleged to be caused directly or indirectly by the content of this training book, software and resources described in it.
We highly encourage contribution to this book and our open source software. The source code for this book can be found in our GitHub repository where you can submit pull requests: .
10% of the proceeds of using our cloud images will go to charity to support orphaned kids in El Salvador - .
Shalom Children’s Home () is one of the ministries that is dear to our hearts located in El Salvador. During the 12 year civil war that ended in 1990, many children were left orphaned or abandoned by parents who fled El Salvador. The Benners saw the need to help these children and received 13 children in 1982. Little by little, more children came on their own, churches and the government brought children to them for care, and the Shalom Children’s Home was founded.
Shalom now cares for over 80 children in El Salvador, from newborns to 18 years old. They receive shelter, clothing, food, medical care, education and life skills training in a Christian environment. The home is supported by a child sponsorship program.
We have personally supported Shalom for over 6 years now; it is a place of blessing for many children in El Salvador that either have no families or have been abandoned. This is good earth to seed and plant.
George Murphy is a Software Engineer who has a long history in the IT and television industry. He has traveled extensively and has many benefits and experiences from doing this. One of those benefits was being able to meet his wife while on a business trip to Hungary. George lives about 20 miles outside of the Washington DC area with his wife Erzsebet and daughter Virag.
He is a highly accomplished senior-level Software Design Engineer with extensive project leadership and solution design experience, successfully managing people, processes, and technology to implement critical enterprise solutions on time. Adept at learning and using new technologies and integrating them into corporate applications. Skilled team leader and mentor with excellent communication skills; can design and support Cloud and on premises applications for clients in diverse industries. Working in the cloud has become such a huge passion for him. Along with that passion has come a never ending thirst to learn new technologies such as Terraform, Nomad, and Vault.
Luis Majano is a Computer Engineer that has been developing and designing software systems since the year 2000. He was born in San Salvador, El Salvador in the late 70’s, during a period of economical instability and civil war. He lived in El Salvador until 1995 and then moved to Miami, Florida where he completed his Bachelors of Science in Computer Engineering at Florida International University. Luis resides in Houston, Texas with his beautiful wife Veronica, baby girl Alexia and baby boy Lucas!
He is the CEO of Ortus Solutions, a consulting firm specializing in web development, ColdFusion (CFML), Java development and all open source professional services under the ColdBox and ContentBox stack. He is the creator of ColdBox, ContentBox, WireBox, MockBox, LogBox and anything “BOX”, and contributes to many open source ColdFusion/Java projects. You can read his blog at www.luismajano.com
Luis has a passion for Jesus, tennis, golf, volleyball and anything electronic. Random Author Facts:
He played volleyball in the Salvadorean National Team at the tender age of 17
The Lord of the Rings and The Hobbit is something he reads every 5 years. (Geek!)
His first ever computer was a Texas Instrument TI-86 that his parents gave him in 1986. After some time digesting his very first BASIC book, he had written his own tic-tac-toe game at the age of 9. (Extra geek!)
He has a geek love for circuits, microcontrollers and overall embedded systems.
He has of late (during old age) become a fan of organic gardening.
Keep Jesus number one in your life and in your heart. I did and it changed my life from desolation, defeat and failure to an abundant life full of love, thankfulness, joy and overwhelming peace. As this world breathes failure and fear upon any life, Jesus brings power, love and a sound mind to everybody!
“Trust in the LORD with all your heart, and do not lean on your own understanding.” Proverbs 3:5
Create an EC2 instance from an Ortus BoxLang engine (Windows Server 2019) AMI (Amazon Machine Image). We have created several Windows-based images to deploy your BoxLang or CFML applications with Compat CFML BoxLang Module.
/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang with CommandBox for Red Hat 8.10
Lucee + IIS-Boncode
✅ (With security updates only)
CommandBox + Boncode
✅ (With security updates only)
Bump BoxLang version to 1.5.0+41
Systemd daemon for manage BoxLang MiniServer process is now boxlang-site
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
/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
Bump BoxLang version to 1.4.0
BoxLang update to 1.3.0
BoxLang MiniServer now support URL Rewrites
Nginx Reverse Proxy
Initial Release
Connecting to your server with WinSCP or VSCode
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.
Bump BoxLang version to 1.5.0+41
Systemd daemon for manage BoxLang MiniServer process is now boxlang-site
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
Bump BoxLang version to 1.4.0
BoxLang update to 1.3.0
BoxLang MiniServer now support URL Rewrites
Nginx Reverse Proxy
Initial Release
Bump BoxLang version to 1.5.0+41
Systemd daemon for manage BoxLang MiniServer process is now boxlang-site
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
Bump BoxLang version to 1.4.0
BoxLang update to 1.3.0
Now, you can deploy your BoxLang or CFML based application on Google Cloud Platform. For deploying this Virtual Machines you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
Bump BoxLang version to 1.5.0+41
Systemd daemon for manage BoxLang MiniServer process is now boxlang-site
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
Bump BoxLang version to 1.4.0
/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang MiniServer for Red Hat 8.10
This Virtual Machine create a runnging ColdBox Site using BoxLang as server with bx-compat-cfml module using CommandBox for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
In Google Cloud Marketplace you find this Virtual Machine offer as BoxLang with CommandBox for RedHat or look for Ortus Solutions, Corp to look for out full catalog.
All of our Cloud Server images follow the following EULA
ORTUS SOLUTIONS CORPORATION
WARRANTY DISCLAIMER AND SOFTWARE PRODUCT LICENSE AGREEMENT
Ortus Cloud Images
Copyright © Ortus Solutions Corp. All Rights Reserved.
IMPORTANT - READ CAREFULLY: This End User License Agreement ("EULA") is a legal agreement between YOU (The End User) as Licensee and ORTUS SOLUTIONS CORPORATION for the SOFTWARE PRODUCT identified above.
Please read this EULA carefully and make sure you fully understand it. You are ONLY permitted to install or use this Software or any future updates to the Software if you AGREE to ALL TERMS AND CONDITIONS contained in this EULA. If you do not agree to all terms, do not use this software or any updates. By installing or using this Software YOU agree to be bound by ALL the terms and conditions below.
This agreement is enforceable like any written negotiated agreement signed by you. You agree that you are bound by the agreement whether you are acting on your own behalf or on behalf of a third party.
1. Definitions.
· “EULA” means this End User License Agreement.
· “Licensee” means YOU or the organization (if any) on whose behalf you are taking the EULA.
· “Software Product” or “Software” means Ortus Cloud Images. The Terms “Software Product” or “Software” also include any future updates to the Software (“Updates”) that are not delivered to YOU under separate terms.
· “Ortus Solutions” means Ortus Solutions Corp, the software developer.
2. Software Licenses.
2.1 With this License YOU are granted the following rights:
To install and use one (1) copy of the Software Product on unlimited web contexts within a single Lucee server instance. This license includes critical patches and bug fixes for a maximum of 1 calendar year since date of purchase. If you purchase a yearly maintenance per Lucee instance, you will be entitled to major, minor and patch updates during the calendar year.
2.2 Limitations
YOU hereby undertake not to sell, rent, lease, translate, adapt, vary, modify, decompile, disassemble, reverse engineer, create derivative works of, modify, sub-license, loan or distribute the SOFTWARE PRODUCT other than as expressly authorized by this EULA.
3. Warranty disclaimer
You may be entitled to warranties, conditions and terms that may not be excluded or limited by Ortus Solutions under law. Except for those non-excludable warranties, conditions and terms, the Software, is made available “As Is.” Except for those non-excludable warranties, conditions and terms, Ortus Solutions makes no warranties, conditions, representations, guarantees or terms (express or implied, whether by statute, common law, custom, usage or otherwise) as to any matter including performance, results, security, no infringement, merchantability, integration, quiet enjoyment, satisfactory quality, and fitness for any particular purpose. This disclaimer of warranty may not be valid in some States. You may have warranty rights under law which may not be waived or disclaimed. Ortus Solutions does not seek to limit your warranty rights to any extent not permitted by law. These exclusions and limitations will apply to the maximum extent permitted by applicable law, even if any remedy fails its essential purpose.
You acknowledge and agree that: Ortus Solutions has no express or implied obligation to continue to make the software or any feature thereof available nor introduce any products or services compatible with the software.
4. Indemnity
The Licensee (YOU) agrees, to the maximum extent permitted by applicable law, to indemnify, defend and hold Ortus Solutions, its members, its successors, officers, principals, directors, agents and employees harmless from any and all actions, causes of action, claims, demands, cost, liabilities, expenses and damages (including attorney’s fees) arising out of, or in connection with any breach of this Agreement by the Licensee and/or the use of the Software Product by the Licensee.
5. Limitation of Liability
Except for any remedies that cannot be excluded or limited under law, Ortus Solutions, will not be liable to YOU for any loss, damages, claims or costs including any indirect, consequential, or incidental damages, any lost profits or lost savings, any damages resulting from business interruption, personal injury or failure to meet any duty of care, or claims by a third party, even if an Ortus Solutions representative has been advised of the possibility of such loss, damages, claims or costs. In any event, Ortus Solutions’ aggregate liability in connection with this agreement will be limited to the amount paid for the Software. This limitation will apply even in the event of a fundamental or material breach or a breach of the fundamental or material terms of this agreement. Nothing contained in this agreement limits Ortus Solutions liability to YOU in the event of death or personal injury resulting from Ortus Solutions’ negligence or for the tort of deceit (fraud). Ortus Solutions is acting on its behalf for the purpose of disclaiming, excluding and limiting obligations, warranties and liability, but in no other respects and for no other purpose.
The foregoing limitations and exclusions apply to the extent permitted by applicable law in your jurisdiction. This limitation of liability may not be valid in some States. You may have rights that cannot be waived under consumer protection and other laws. Ortus Solutions does not seek to limit your warranty or remedies to any extent not permitted by law.
6. Governing Law
This agreement will be governed by and construed in accordance with the substantive law of: The State of Texas.
7. Assignment
Neither this Agreement nor any of the rights, interests or obligations under this Agreement shall be assigned, in whole or in part, by operation of law or otherwise by the Licensee without the prior written consent of Ortus Solutions.
8. Non Waiver
Ortus Solutions’ failure to exercise or delay in exercising any right, power or privilege under this Agreement shall not operate as a waiver thereof; nor shall any single or partial exercise of any right, power or privilege preclude any other or further exercise thereof.
No breach of any provision of this Agreement will be waived except with the express written consent of Ortus Solutions.
9. Attorney and litigation
In the event of litigation between Ortus Solutions and the Licensee relating to the subject matter of this Agreement, the non-prevailing party shall reimburse the prevailing party for all reasonable attorney fees and costs resulting from the litigation process.
10. General Provisions
Your rights to use the Software terminate immediately if you do not comply with any term of this agreement. If any provision of this agreement is found unenforceable, only that provision, interpreted as narrowly as possible, will be held unenforceable and the rest of this agreement will remain valid and enforceable according to its terms. Section 4 shall survive the termination of this agreement. This agreement shall not prejudice the statutory rights of any party dealing as a consumer. This agreement may only be modified by a writing signed by an authorized officer of Ortus Solutions. This agreement is the entire agreement between Ortus Solutions and you relating to the Software Product, and it supersedes any prior representations, discussions, undertakings, communications or advertising relating to the Software Product.
If you have any questions regarding this document or if you wish to request any information from Ortus Solutions please contact us via web at
Lucee, Mod_cfml, and Nginx are companies NOT associated with Ortus Solutions.
In this section you will find all the server images we have created so you can run on AWS as either EC2 instances or ECS Containers.
What is an ec2 instance? It is simply a virtual machine running in the AWS (Amazon Web Services) cloud. EC2 stands for Elastic Compute Cloud. An on-demand ec2 instance is a virtual machine that a user can rent by the minute, hour or annually, which ever his use need may dictate. Ortus Solutions has seen a long need to bring Lucee servers to the AWS cloud. What are it's benefits? You can have a site up and running in minutes without going through configuration hell. There are many people still running legacy applications who see a need to upgrade for security purposes or modernization reasons. It just makes since to remove your servers from on premises providers and move to the cloud. If you want customization on the AMI image we can help you.
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html
Going forward we will show you how to create an AWS ec2 web site using our Ortus hardened AMI's even if you have never done this before. The first thing you will need to do is setup an [AWS account]() if you do not have one.
The AWS marketplace is the place to find the Ortus Lucee CFML engine (Ubuntu Server 18.04 LTS) AMI (Amazon Machine Image). You have a choice of a multitude of different sizes and use agreements. This includes from the free tier to the high performance paid tier. If you already have an Amazon account go login and go the Amazon Marketplace at this URL Once on this URL search for Ortus. From there click the subscribe button off to the right.
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 MiniServer 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.
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 MiniServer for Windows 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.
By default you are given 2 web sites. This page will show you how to display and edit those 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:
Initial Release
/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang update to 1.3.0
Bump BoxLang version to 1.4.0
/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang update to 1.3.0
BoxLang MiniServer now support URL Rewrites
Internet Information Services
Initial Release
/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang MiniServer now support URL Rewrites
Nginx Reverse Proxy for URL Rewrites
BoxLang update to 1.3.0
Bump BoxLang version to 1.5.0+41
Systemd daemon for manage BoxLang MiniServer process is now boxlang-site
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
Bump BoxLang version to 1.4.0
BoxLang update to 1.3.0
BoxLang MiniServer now support URL Rewrites
Nginx Reverse Proxy
Initial Release
Restart Nginx and restart the server. Open your new site.
3.229.122.138 website1.com
3.229.122.138 website2.com/etc/nginx/sites-enabled# ls
website1.conf website2.conf
cat website2.conf###############################################################
# Example
###############################################################
server {
################### SERVER NAME AND PORT #####################
listen 80;
server_name website2.com;
################### LOGS #####################
access_log /var/log/nginx/website2-access.log;
error_log /var/log/nginx/website2-error.log warn;
rewrite_log off;
################### LOCATION #####################
root /var/www/website2;
################### CFML #####################
# Mod_cfml (Lucee) specific: add a unique ID for this server block.
# For more info, see http://www.modcfml.org/index.cfm/install/web-server-components/nginx-all-os/
set $lucee_context "website2.com";
set $application_port "8002";
include lucee.conf;
}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!



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 m4.large. 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.
Connect to your EC2 instance using Remote Desktop Protocol (RDP) or SSH to perform the following commands for creating a new handler in ColdBox Sample Application
Change your current directory to C:\inetpub\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!



VSCode is one of the hottest new editors on the market. We will show you how to connect via VSCode using the VSCode Remote Development Extension.
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."
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.
Connecting to your server with WinSCP or VSCode
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.
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 Azure Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need a Microsoft Subscription, if not have one follow this link to get 200 USD of credits.
In Azure Marketplace you find this Virtual Machine offer as BoxLang MiniServer for Windows or look for Ortus Solutions, Corp to look for out full catalog.
In the overview product click on create button to start deployment proccess
In Basics tab select your Azure Subscription, resource group and region where Virtual Machine reside. Also, you set here Name, Availability zone, Size, Username and your desired method to login of your Virtual Machine.
Disks tab let you set up additional managed disk for your Virtual Machine, We recommend to add one additional data disk to store your data. If you change a different size for disk read documentation.
In Networking you set up Virtual Network, Subnet, Public IP and Network Security (this can be default or make a custom by you). If Virtual Machine size selected is compatible you can enable Accelerated networking. Also if you plan to deploy this Virtual Machine behind a Load Balancer you can config that from here.
Management tab let you configure Identity for your Virtual Machine, Auto-shutdown, backups and Guest OS update. Some features are available only for certain Virtual Machines size, if you want to review more detailed documentation about features availability follow this .
In Monitoring tab you can Alerts, Boot diagnostics and Health monitoring for your Virtual Machine.
In Adavance you can add Extensions, Application or Custom scripts with cloud-init and configuration related to where is located physically your Virtual Machine.
Tags tab let you tagging your virtual machine and dependent resources.
Review + create tab let you see all your configurations and alerts you if any of them need review or change, if not, click on create to deploy your BoxLang with CommandBox Ubuntu 24.04 Virtual Machine.
This Azure Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need a Microsoft Subscription, if not have one follow this link to get 200 USD of credits.
In Azure Marketplace you find this Virtual Machine offer as BoxLang with CommandBox for Windows or look for Ortus Solutions, Corp to look for out full catalog.
In the overview product click on create button to start deployment proccess
In Basics tab select your Azure Subscription, resource group and region where Virtual Machine reside. Also, you set here Name, Availability zone, Size, Username and your desired method to login of your Virtual Machine.
Disks tab let you set up additional managed disk for your Virtual Machine, We recommend to add one additional data disk to store your data. If you change a different size for disk read documentation.
In Networking you set up Virtual Network, Subnet, Public IP and Network Security (this can be default or make a custom by you). If Virtual Machine size selected is compatible you can enable Accelerated networking. Also if you plan to deploy this Virtual Machine behind a Load Balancer you can config that from here.
Management tab let you configure Identity for your Virtual Machine, Auto-shutdown, backups and Guest OS update. Some features are available only for certain Virtual Machines size, if you want to review more detailed documentation about features availability follow this .
In Monitoring tab you can Alerts, Boot diagnostics and Health monitoring for your Virtual Machine.
In Adavance you can add Extensions, Application or Custom scripts with cloud-init and configuration related to where is located physically your Virtual Machine.
Tags tab let you tagging your virtual machine and dependent resources.
Review + create tab let you see all your configurations and alerts you if any of them need review or change, if not, click on create to deploy your BoxLang with CommandBox Ubuntu 24.04 Virtual Machine.
There are several great VSCode plugins in this extension called Remote Development. These plugins allow you to connect directly to your Ortus AWS instance from any platform and start developing.
Becoming a box hero is a fairly straight forward process:
Here is the link to install your Remote Development extension to VSCode. https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack Once you have your extension installed you will need some assets to get started.
Windows Password
Public EC2 IP address
pem file location that you created when you built your EC2 instance
Next let's open VSCode. Hold this key combination Ctrl +Shift + P and type Config. You will see some options. Select Remote-SSH: Open Configuration File.... This will open a file for you that has been prefilled with this information. If IdentityFile is not there add it please. Replace EC2 Public IP in the hostname and IdentityFile. Give the real name and and location of the pem file. Copy your Windows Password to the clipboard. Now go to the bottom left corner of VSCode. You will see a green square. Hover your mouse over it. It should say "Open a remote window." Click the green square. Select Remote-SSH: Connect to Host... Select your Alias whatever you put in for Alias. It should open a dropdown box asking for the password for windows. Put in your password and hit the enter key. A new instance of VSCode will open. The green rectangle where you launched from should read "SSH:Alias-name."
Now let's run this keyboard combination command Ctrl + Shift + E this will open the file explorer window where your web site files are on the EC2 instance. Click the "Open Folder" blue bar. It will try and send you to C:\Users\Administrator change to:
This is going to allow you to have direct access to the files on your EC2 instances. CommandBox is preloaded so you can create any views, handlers and things of that nature.
This page will describe how to manage your web site once you have remote desktop onto the server or used SSH to access the server.
You have a default ColdBox Template site running at C:\inetpub\wwwroot in the IIS "Default Web Site." If you want a different site you can remove all folders except BIN and WEB-INF. But before you do that familiarize yourself with how to access the site and the Lucee administrator. It is fairly simple the site is at http://localhost/ (web site) http://localhost/lucee/admin/server.cfm (Lucee Administrator)
The Lucee Password is the EC2 Instance ID. Once on the server we strongly urge you to change this password immediately.
According to the author of Boncode: "This is the modern method of connecting IIS and Apache Tomcat. Most likely to use a Lucee or JSP driven backend. The BonCode AJP (Apache JServ Protocol version 1.3) Connector uses already existing pathways to connect to Apache Tomcat. The AJP implementation is generic and will work to connect IIS with any AJP server such as Jboss, web-methods, Jetty etc. In general it is a preference question how you connect IIS to Tomcat, though, there are several advantages with the BonCode connector vs the old ISAPI connector."
What is an Azure Virtual Machine? As its name say, It is a simple virtual machine running in Microsoft Azure Cloud. Azure Virtual Machines (Azure VM) is Infrastructure as a Service for computing, this gives you more control over your cloud resources. With this service you can pay as you go or annualy reservation. But if you want more detailed information about this service, you can look at this.
For deploying this Virtual Machine you need a Microsoft Subscription, if not have one follow this to get 200 USD of credits.
Azure Microsoft is the place where you can find our Ortus BoxLang Cloud Servers, you can deploy from here and see the differents plans to use them. You are able to deploy a simple tiny server of high performance server, if you already have a Subscription, login with you Microsoft Account and look at our BoxLang Virtual Machines offers at this URL https://azuremarketplace.microsoft.com/en-us/marketplace/apps?page=1&search=BoxLang
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
This Virtual Machine create a runnging ColdBox Site using BoxLang as server with bx-compat-cfml module using CommandBox for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this also, you can get 300 USD of credits.
To be subscribed to Virtual Machine offer
This page will explain the necessary sites to run Contentbox 5 on your AWS Cloud site. Let's take care of some homework first. The GUI part of the Lucee admin is disabled on Contentbox 5. The sites are at: C:\inetpub\wwwroot\site1 | C:\inetpub\wwwroot\site2 Commandbox is at C:\box All Lucee admin functionality can be ministered maintained via the Commandbox module CFConfig. Here is a link to get you started with that. To see your Lucee admin settings open a CLI and open a box shell and run. cfconfig show
Now let's get Contentbox configured and running on the demo site. If you are an experienced user then create your own site. Here are the steps to get that first site running.
Open a browser and if you have not run this at the bottom of the page you will need to or do it by hand. Paste this URL into your browser and go. http://luceesite1.com
There are several great VSCode plugins in this extension called Remote Development. These plugins allow you to connect directly to your Ortus AWS instance from any platform and start developing.
[01:31 PM]-[otisnado@otisnado-ortushp]-[~]-
$ ssh [email protected]
ubuntu@ip-172-31-28-63:~$ubuntu@ip-172-31-28-63:~$ sudo su
root@ip-172-31-28-63:/home/ubuntu# cd /web/coldbox-site/wwwroot/
root@ip-172-31-28-63:/web/coldbox-site/wwwroot# boxWelcome to CommandBox!
CommandBox:wwwroot> coldbox create handler type=index name=helloFromBoxlangMiniserverCloudServer
INFO Created View [/web/coldbox-site/wwwroot/views/helloFromBoxlangMiniserverCloudServer/index.cfm]
INFO Created Handler [/web/coldbox-site/wwwroot/handlers/helloFromBoxlangMiniserverCloudServer.cfc]
INFO Created Integration Spec [/web/coldbox-site/wwwroot/tests/specs/integration/helloFromBoxlangMiniserverCloudServerTest.cfc]
CommandBox:wwwroot>PS C:\Users\administrator> Set-Location C:\inetpub\wwwroot\
PS C:\inetpub\wwwroot> boxWelcome to CommandBox!
CommandBox:wwwroot> coldbox create handler type=index name=helloFromBoxLangMiniServer
INFO Created View [C:\inetpub\wwwroot\views\helloFromBoxLangMiniServer/index.cfm]
INFO Created Handler [C:\inetpub\wwwroot\handlers\helloFromBoxLangMiniServer.cfc]
INFO Created Integration Spec [C:\inetpub\wwwroot\tests\specs\integration\helloFromBoxLangMiniServerTest.cfc]
CommandBox:wwwroot>































Host alias
HostName EC2 Public IP
User Administrator
IdentityFile ssh -i ~/.ssh/created.pem Administrator@EC2-Public-IPC:\imetpub\wwwrootPublic EC2 IP address
pem file location that you created when you built your EC2 instance
Next let's open VSCode. Hold this key combination Ctrl +Shift + P and type Config. You will see some options. Select Remote-SSH: Open Configuration File.... This will open a file for you that has been prefilled with this information. If IdentityFile is not there add it please. Replace EC2 Public IP in the hostname and IdentityFile. Give the real name and and location of the pem file. Copy your Windows Password to the clipboard. Now go to the bottom left corner of VSCode. You will see a green square. Hover your mouse over it. It should say "Open a remote window." Click the green square. Select Remote-SSH: Connect to Host... Select your Alias whatever you put in for Alias. It should open a dropdown box asking for the password for windows. Put in your password and hit the enter key. A new instance of VSCode will open. The green rectangle where you launched from should read "SSH:Alias-name."
Now let's run this keyboard combination command Ctrl + Shift + E this will open the file explorer window where your web site files are on the EC2 instance. Click the "Open Folder" blue bar. It will try and send you to C:\Users\Administrator change to:
This is going to allow you to have direct access to the files on your EC2 instances. CommandBox is preloaded so you can create any views, handlers and things of that nature.
Host alias
HostName EC2 Public IP
User Administrator
IdentityFile ssh -i ~/.ssh/created.pem Administrator@EC2-Public-IPC:\imetpub\wwwrootClick the accept terms 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.
On the "Name and tags" page. Let's add a tag. Click the add Tag. They should be Key=Name and Value=Ortus Lucee CFML engine 5.2.9.31 (Ubuntu Server 18.04 LTS) Resource type=Instances.
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.
If You desire or You do not have Key pair, You can generate new ones in "Key pair (login)" section. SAVE IT IN A SECURE PLACE!
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.
On "Summary" section you can review general information about your instance, cancel operation, launch instance and also, you can generate AWS CLI commands to deploy EC2 instance with desired configuration.
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.
SSH to your instance with following command ssh -i "/path/to/your/private-key" ubuntu@ec2-{public\_dns}.compute-1.amazonaws.com
When you SSH to the instance the web root is /web/coldbox-site/wwwroot RUN cd COMMAND WITH SUDO OR su TO ROOT USER
Enjoy your servers!

Project Editor or Compute Admin roles in Google Cloud project
A Service Account with Cloud Infrastructure Manager Agent Compute Admin and Service Account User roles
In Google Cloud Marketplace you find this Virtual Machine offer as BoxLang with CommandBox for Ubuntu or look for Ortus Solutions, Corp to look for out full catalog.
Accept Terms and agreements to subscribe to Virtual Machine offer
Deployment config: Set up your deployment with a name, use an existent service account or create a new one for deploying and select the Zone where you want to deploy your virtual machine
Machine type: Select Virtual Machine type and size for your Boot disk
Networking: Select Network, Subnetwork and External IP configuration for your Virtual Machine
Finally select open ports to be available from internet
Once your Virtual Machine is deployed, you can view it from Google Compute Engine console. To connect through SSH, click in SSH button a side of your Virtual Machine. You can copy Private and Public IP to connect you at HTTP (80) port.
When connect through SSH using web console a new window is opened asking for authorize to load your Google Cloud user's SSH keys into virtual machine
If you want to load your own SSH keys or connect to your Virtual Machone with differents SSH clients, follow this link for more information about it.
Set the email address
Create the CMS


Host ColdBoxDemo
User ubuntu
HostName 34.236.192.135
IdentityFile ~/.ssh/my-pem-that-i-downloaded-when-creating-ec2.pemCreate a Azure Virtual Machine from an Ortus BoxLang MiniServer (Red Hat 8) Virtual Machine (Azure Virtual Machine). We have created several Red Hat based images.
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Re Hat based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Due these Cloud Servers are Red Hat 8 based, you can follow this to know more about base software running.
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.
Create an EC2 instances from an Ortus BoxLang engine (Red Hat Enterprise Linux 8) AMI (Amazon Machine Image). We have created several based Red Hat based images.
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Red Hat based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Due these Cloud Servers are Red Hat Enterprise Linux (RHEL) for AWS based, you can follow this to know more about base software running.
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 show you how to mange your site using CommandBox and how to move files back and forth from your your development environment where ever that may be.
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.
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/
VSCode the editor of choice, and the reason I say that is because it has so many useful extensions. https://code.visualstudio.com/download
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.
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 with CommandBox for Windows 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 m4.large. 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.
Connect to your EC2 instance using Remote Desktop Protocol (RDP) or SSH to perform the following commands for creating a new handler in ColdBox Sample Application
Change your current directory to C:\inetpub\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!
This page will show you how to mange your site using CommandBox and how to move files back and forth from your your development environment where ever that may be.
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.
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/
VSCode the editor of choice, and the reason I say that is because it has so many useful extensions. https://code.visualstudio.com/download
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.
Create a Google Cloud Virtual Machine from an Ortus BoxLang MiniServer (Windows 2019) Virtual Machine (Google Compute Engine). We have created several Windows based images.
This Azure Virtual Machine create a runnging ColdBox Site using BoxLang as CFML Engine for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need a Microsoft Subscription, if not have one follow this to get 200 USD of credits.
In Azure Marketplace you find this Virtual Machine offer as or look for Ortus Solutions, Corp to look for out full catalog.
This Virtual Machine create a runnging ColdBox Site using BoxLang as server with bx-compat-cfml module using CommandBox for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this also, you can get 300 USD of credits.
To be subscribed to Virtual Machine offer
This documentation is born out of a need to keep introducing our customers to new and innovative products. There are just too many folks who want to be in the Cloud but have no idea of how to get there. This guide is intended to be a journal on how to move your products to the ANY cloud using any of the supported providers.
Amazon Web Services (Available now!)
Welcome to BoxLang Cloud Servers
Welcome to the repository of documentation for the that you can use to deploy BoxLang / CFML applications to the cloud on the following providers:
Amazon Web Services (AWS)
Azure Cloud (Available now!)
Google Cloud (Available now!
choco install vscode --version=1.36.1 -y/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang update to 1.3.0
ColdBox Application
latest
✅
✅
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BVM_HOME
/usr/local/boxlang
BoxLang Version Manager home
BoxLang MiniServer
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver
BoxLang with CommandBox
/bin/box server start serverConfigFile=server.json
/usr/local/bin/box server start serverConfigFile=server.json
coldbox-site
ColdBox Application
latest
✅
✅
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BVM_HOME
/usr/local/boxlang
BoxLang Version Manager home
BoxLang MiniServer
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver
BoxLang with CommandBox
/bin/box server start serverConfigFile=server.json
/usr/local/bin/box server start serverConfigFile=server.json
coldbox-site























This AMI create a runnging ColdBox Site using BoxLang as server with bx-compat-cfml module using CommandBox 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/)
In AWS Marketplace you find this AMI offer as BoxLang with CommandBox for RedHat or look for Ortus Solutions, Corp to look for out full catalog.
#Install Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
#Assign Packages to Install
$Packages = 'commandbox',`
'vscode',`
'winscp'
#Install Packages
ForEach ($PackageName in $Packages)
{choco install $PackageName -y}PS> .\anything.ps1 (enter)#Install Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
#Assign Packages to Install
$Packages = 'commandbox',`
'vscode',`
'winscp'
#Install Packages
ForEach ($PackageName in $Packages)
{choco install $PackageName -y}PS> .\anything.ps1 (enter)On every Ubuntu based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Due these Cloud Servers are Ubuntu 24.04 LTS based, you can follow this link to know more about base software running.
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BVM_HOME
/usr/local/boxlang
BoxLang Version Manager home
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.
BoxLang MiniServer
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver
BoxLang with CommandBox
/bin/box server start serverConfigFile=server.json
/usr/local/bin/box server start serverConfigFile=server.json
coldbox-site
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Windows based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Due these Cloud Servers are Windows 2019 based, you can follow this link to know more about base software running.
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BVM_HOME
/usr/local/boxlang
BoxLang Version Manager home
For every Windows based BoxLang Cloud Server a scheduled task is used to get up and running a Web Server on well know HTTP port 80/TCP. You can find this scheduled task as name "Start ColdBox Sample Application", depending of the server flavor this can be started using BoxLang MiniServer or CommandBox. If you want to start your any custom site, you can update this task if need it, or just only place your custom site under C:\inetpub\wwwroot folder
BoxLang MiniServer
C:\boxlang\bin\boxlang-miniserver.bat --host 0.0.0.0 --port 80 --webroot C:\inetpub\wwwroot --rewrites index.cfm
Start ColdBox Sample Application
BoxLang with CommandBox
C:\box\box.exe -commandbox_home=C:/CommandBox server start serverConfigFile="C:\inetpub\wwwroot\server.json"
Start ColdBox Sample Application
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
In Basics tab select your Azure Subscription, resource group and region where Virtual Machine reside. Also, you set here Name, Availability zone, Size, Username and your desired method to login of your Virtual Machine.
Disks tab let you set up additional managed disk for your Virtual Machine, We recommend to add one additional data disk to store your data. If you change a different size for disk read How expand your partition size documentation.
In Networking you set up Virtual Network, Subnet, Public IP and Network Security (this can be default or make a custom by you). If Virtual Machine size selected is compatible you can enable Accelerated networking. Also if you plan to deploy this Virtual Machine behind a Load Balancer you can config that from here.
Management tab let you configure Identity for your Virtual Machine, Auto-shutdown, backups and Guest OS update. Currently we are working to support Microsoft Entra ID authentication, but if want to enable out of the box, follow this link.
In Monitoring tab you can Alerts, Boot diagnostics and Health monitoring for your Virtual Machine.
In Adavance you can add Extensions, Application or Custom scripts with cloud-init and configuration related to where is located physically your Virtual Machine.
Tags tab let you tagging your virtual machine and dependent resources.
Review + create tab let you see all your configurations and alerts you if any of them need review or change, if not, click on create to deploy your BoxLang with CommandBox Ubuntu 24.04 Virtual Machine.
Project Editor or Compute Admin roles in Google Cloud project
A Service Account with Cloud Infrastructure Manager Agent Compute Admin and Service Account User roles
In Google Cloud Marketplace you find this Virtual Machine offer as BoxLang with CommandBox for RedHat or look for Ortus Solutions, Corp to look for out full catalog.
Accept Terms and agreements to subscribe to Virtual Machine offer
Deployment config: Set up your deployment with a name, use an existent service account or create a new one for deploying and select the Zone where you want to deploy your virtual machine
Machine type: Select Virtual Machine type and size for your Boot disk
Networking: Select Network, Subnetwork and External IP configuration for your Virtual Machine
Finally select open ports to be available from internet
Once your Virtual Machine is deployed, you can view it from Google Compute Engine console. To connect through SSH, click in SSH button a side of your Virtual Machine. You can copy Private and Public IP to connect you at HTTP (80) port.
When connect through SSH using web console a new window is opened asking for authorize to load your Google Cloud user's SSH keys into virtual machine
If you want to load your own SSH keys or connect to your Virtual Machone with differents SSH clients, follow this link for more information about it.
Azure Cloud (Available now!)
Google Cloud (Available now!)
Digital Ocean (Coming soon)
Here is a listing of the cloud servers that are available now or in progress of being built.
BoxLang MiniServer for Windows
✅
✅
✅
BoxLang MiniServer for Ubuntu
✅
✅
✅
BoxLang MiniServer for Red Hat
✅
Lucee+Nginx+Ubuntu
AWS
✅
Lucee+IIS+Windows
AWS
✅
Digital Ocean (Coming soon)








Create an EC2 instance from an Ortus BoxLang engine (Windows Server 2019) AMI (Amazon Machine Image). We have created several Windows-based images to deploy your BoxLang or CFML applications with Compat CFML BoxLang Module.
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Windows based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Due these Cloud Servers are Windows Server 2019 based, you can follow this to know more about base software running.
For every Windows based BoxLang Cloud Server a scheduled task is used to get up and running a Web Server on well know HTTP port 80/TCP. You can find this scheduled task as name "Start ColdBox Sample Application", depending of the server flavor this can be started using BoxLang MiniServer or CommandBox. If you want to start your any custom site, you can update this task if need it, or just only place your custom site under C:\inetpub\wwwroot folder
Create an Azure Virtual Machine from an Ortus BoxLang with CommandBox (Windows Server 2019) Virtual Machine (Azure VM). We have created several based Windows based images.
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Windows based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Due these Cloud Servers are Windows Server 2019 based, you can follow this to know more about base software running.
For every Windows based BoxLang Cloud Server a scheduled task is used to get up and running a Web Server on well know HTTP port 80/TCP. You can find this scheduled task as name "Start ColdBox Sample Application", depending of the server flavor this can be started using BoxLang MiniServer or CommandBox. If you want to start your any custom site, you can update this task if need it, or just only place your custom site under C:\inetpub\wwwroot folder
What is Contentbox 5. It is one of the most popular free open source CMS on the market today. This release from Contentbox 4 is a major upgrade for the platform. We can go more indepth about the product at this URL. https://contentbox.ortusbooks.com/intro/release-history/whats-new-with-5.3.0 Part of that upgrade is bringing it to the AWS Cloud as a multi-instance Lucee CommandBox server. It comes with MySQL 5.7 already installed, and CommandBox. This AMI image comes with 2 instances of Lucee 5.3.9 running Contentbox 5.x.
In order to standup your cloud server you will need an AWS account. You can read about how to do that at this link. https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/
Head on over to the AWS Marketplace and search for Ortus. https://aws.amazon.com/marketplace/
Click the Contentbox 5 continue to subscribe button.
Accept the terms.
Click the link below to launch a new instance.
Next the choose an instance type comes up. We strongly suggest you choose an instance type with at least 8GB of ram and 2 to 4 CPU's. We have found that the c5.xlarge works really nicely. It has 4 CPU's and 8GB of ram.
You are on the "Configure Instance Details" page keep the defaults. Go to the bottom of the page and click the "Next: Add Storage" button.
The default for storage is 30 GB. I usually bump that up to 60 GB. Remember it is Windows.
Click the add Tag. Key=Name and Value=Ortus Lucee Commandbox Multisite (Windows Server 2019) Contentbox 5.0. Next go to the bottom of the page and click the button that says "Next: Configure Security Group." If you will notice I have selected my ip for all of the selected protocols. This is so that we can keep everything private until all is configured then we can open port 80 and 443 up.
Go to the bottom right of the page and select and click the "Review and Launch" button. This opens a module window that prompts you to an existing key pair or to create a new key pair. 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 buttons at the top right of the page. Click the connect button at the top right of the page.
Select the RDP client tab. This will open a dialog asking you to download your Windows RDP file and decrypt your Windows Administrator password using the pem file you downloaded or the pem file you selected. Click the Get password link.
After clicking the Get password link you will be asked to browse to where you have stored your pem file and select it. Then you click decrypt password button and then you copy your password.
Now lets double click your downloaded RDP file. This will open your window to log onto the server. Once on the server let's open Powershell ISE. Then let's copy and paste this code in Powershell. This will setup your Windows host file to run these two Contentbox demo sites for you.
This AMI image will create a running Lucee Windows 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 Lucee CFML Server (Windows 2019+Boncode+Tomcat) 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
Click the accept terms button
Configuration options for subscription. In this section you can chose 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 choso method to launch, for this case, We're going to use EC2 method.
On the "Name and tags" page. Let's add a tag. Click the add Tag. They should be Key=Name and Value=Ortus Lucee CFML engine 5.3.6.61 (Windows Server 2019) Resource type=Instances.
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. For this guide We're using t2.medium size.
If You desire or You do not have Key pair, You can generate new ones in "Key pair (login)" section. SAVE IT IN A SECURE PLACE!
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.
On "Summary" section you can review general information about your instance, cancel operation, launch instance and also, you can generate AWS CLI commands to deploy EC2 instance with desired configuration.
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. Click on "Connect" at the top of the page. Then click "RDP client". Click on "Get password" button, this will open a dialog asking you to decrypt your Windows RDP administrative password using the pem file you downloaded or the pem file you selected.
Download remote desktop file and Log in to manage your instnace.
Create a Google Cloud Virtual Machine from an Ortus BoxLang MiniServer (RedHat 8) Virtual Machine (Google Compute Engine). We have created several RedHat based images.
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Red Hat based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Due these Cloud Servers are Red Hat 8 based, you can follow this to know more about base software running.
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 AMI will allow you to configure as many Lucee sites as you desire using CommandBox and Nginx as a front end LB.
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!
This Virtual Machine create a runnging ColdBox Site using BoxLang as server with bx-compat-cfml module using CommandBox for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
To be subscribed to Virtual Machine offer
Project Editor or Compute Admin roles in Google Cloud project
A Service Account with Cloud Infrastructure Manager Agent Compute Admin and Service Account User roles
In Google Cloud Marketplace you find this Virtual Machine offer as or look for Ortus Solutions, Corp to look for out full catalog.
Accept Terms and agreements to subscribe to Virtual Machine offer
Deployment config: Set up your deployment with a name, use an existent service account or create a new one for deploying and select the Zone where you want to deploy your virtual machine
Machine type: Select Virtual Machine type and size for your Boot disk
Networking: Select Network, Subnetwork and External IP configuration for your Virtual Machine
Finally select open ports to be available from internet
Once your Virtual Machine is deployed, you can view it from Google Compute Engine console. To connect through SSH, click in SSH button a side of your Virtual Machine. You can copy Private and Public IP to connect you at HTTP (80) port.
When connect through SSH using web console a new window is opened asking for authorize to load your Google Cloud user's SSH keys into virtual machine
If you want to load your own SSH keys or connect to your Virtual Machone with differents SSH clients, follow this for more information about it.
Create an Azure Virtual Machine from an Ortus BoxLang with CommandBox (Ubuntu Server 24.04 LTS) Virtual Machine (Azure VM). We have created several based Ubuntu based images.
Create a Google Cloud Virtual Machine from an Ortus BoxLang MiniServer (Ubuntu 24.04 LTS) Virtual Machine (Google Compute Engine). We have created several Ubuntu based images.
This AMI create a runnging ColdBox Site using BoxLang with bx-compat-cfml 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.]( )
In AWS Marketplace you find this AMI offer as or look for Ortus Solutions, Corp to look for out full catalog.
PS C:\Users\administrator> Set-Location C:\inetpub\wwwroot\
PS C:\inetpub\wwwroot> boxWelcome to CommandBox!
CommandBox:wwwroot> coldbox create handler type=index name=helloFromBoxLangMiniServer
INFO Created View [C:\inetpub\wwwroot\views\helloFromBoxLangMiniServer/index.cfm]
INFO Created Handler [C:\inetpub\wwwroot\handlers\helloFromBoxLangMiniServer.cfc]
INFO Created Integration Spec [C:\inetpub\wwwroot\tests\specs\integration\helloFromBoxLangMiniServerTest.cfc]
CommandBox:wwwroot>BoxLang update to 1.3.0
ColdBox Application
latest
✅
✅
ColdBox Application
latest
✅
✅
✅
✅
BoxLang with CommandBox for Windows
✅
✅
✅
BoxLang with CommandBox for Ubuntu
✅
✅
✅
BoxLang with CommandBox for Red Hat
❌ Public visibility pending
✅
✅
ColdBox Application
latest
✅
✅
Tool name
Version installed
BoxLang MiniServer
BoxLang + CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Variable
Default value
Description
BOXLANG_HOME
C:\boxlangHome
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
C:\CommandBox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BoxLang MiniServer
C:\boxlang\bin\boxlang-miniserver.bat --host 0.0.0.0 --port 80 --webroot C:\inetpub\wwwroot --rewrites index.cfm
Start ColdBox Sample Application
BoxLang with CommandBox
C:\box\box.exe -commandbox_home=C:/CommandBox server start serverConfigFile="C:\inetpub\wwwroot\server.json"
Start ColdBox Sample Application
ColdBox Application
latest
✅
✅
Tool name
Version installed
BoxLang MiniServer
BoxLang + CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Variable
Default value
Description
BOXLANG_HOME
C:\boxlangHome
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
C:\CommandBox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BoxLang MiniServer
C:\boxlang\bin\boxlang-miniserver.bat --host 0.0.0.0 --port 80 --webroot C:\inetpub\wwwroot --rewrites index.cfm
Start ColdBox Sample Application
BoxLang with CommandBox
C:\box\box.exe -commandbox_home=C:/CommandBox server start serverConfigFile="C:\inetpub\wwwroot\server.json"
Start ColdBox Sample Application
ColdBox Application
latest
✅
✅
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BVM_HOME
/usr/local/boxlang
BoxLang Version Manager home
BoxLang MiniServer
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver
BoxLang with CommandBox
/bin/box server start serverConfigFile=server.json
/usr/local/bin/box server start serverConfigFile=server.json
coldbox-site


































Bump BoxLang version to 1.5.0+41
Systemd daemon for manage BoxLang MiniServer process is now boxlang-site
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
Bump BoxLang version to 1.4.0
BoxLang update to 1.3.0
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.
Lucee + Nginx
✅ (With security updates only)
CommandBox + Nginx
✅ (With security updates only)
This Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
In Google Cloud Marketplace you find this Virtual Machine offer as BoxLang MiniServer for RedHat or look for Ortus Solutions, Corp to look for out full catalog.
ssh -i "/local-path-to/myfile.pem" ubuntu@ec2-{public_dns}.compute-1.amazonaws.com
When you CD to the instance the 2 web roots are at sudo su cd /var/www/website1 /var/www/website2
On every Ubuntu based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Due these Cloud Servers are Ubuntu 24.04 LTS based, you can follow this link to know more about base software running.
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
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.
BoxLang MiniServer
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver
BoxLang with CommandBox
/bin/box server start serverConfigFile=server.json
/usr/local/bin/box server start serverConfigFile=server.json
coldbox-site
BoxLang MiniServer
✅
BoxLang with CommandBox
✅
On every Ubuntu based Cloud Server you will find software or tools to achieve best experience with our solutions. This software include:
Tool name
Version installed
BoxLang MiniServer
BoxLang with CommandBox
CommandBox
latest
✅
✅
BoxLang runtime
latest
✅(As OS binary)
✅(Into CommandBox)
BoxLang MiniServer (As OS binary)
latest
✅
❌
Due these Cloud Servers are Ubuntu 8 based, you can follow this link to know more about base software running.
Variable
Default value
Description
BOXLANG_HOME
/root/.boxlang
Directory where BoxLang place configs and modules
COMMANDBOX_HOME
/root/.commandbox
Directory where CommandBox place configs and modules
BOXLANG_TARGET_VERSION
latest
BoxLang version installed and to be used for BoxLang
BVM_HOME
/usr/local/boxlang
BoxLang Version Manager home
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.
BoxLang MiniServer
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver --host 0.0.0.0 --port 80 --webroot /web/boxlang-site/wwwroot --rewrites index.cfm
boxlang-miniserver
BoxLang with CommandBox
/bin/box server start serverConfigFile=server.json
/usr/local/bin/box server start serverConfigFile=server.json
coldbox-site
BoxLang MiniServer
✅
BoxLang with CommandBox
✅















/web/coldbox-site/wwwroot directory was moved to /web/boxlang-site/wwwroot
BoxLang update to 1.3.0
ColdBox Application
latest
✅
✅
ColdBox Application
latest
✅
✅













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 with CommandBox 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!
This Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
To be subscribed to Virtual Machine offer
Project Editor or Compute Admin roles in Google Cloud project
A Service Account with Cloud Infrastructure Manager Agent Compute Admin and Service Account User roles
In Google Cloud Marketplace you find this Virtual Machine offer as or look for Ortus Solutions, Corp to look for out full catalog.
Accept Terms and agreements to subscribe to Virtual Machine offer
Deployment config: Set up your deployment with a name, use an existent service account or create a new one for deploying and select the Zone where you want to deploy your virtual machine
Machine type: Select Virtual Machine type and size for your Boot disk
Networking: Select Network, Subnetwork and External IP configuration for your Virtual Machine
Finally select open ports to be available from internet
Once your Virtual Machine is deployed, you can view it from Google Compute Engine console. To connect through SSH, click in SSH button a side of your Virtual Machine. You can copy Private and Public IP to connect you at HTTP (80) port.
When connect through SSH using web console a new window is opened asking for authorize to load your Google Cloud user's SSH keys into virtual machine
If you want to load your own SSH keys or connect to your Virtual Machone with differents SSH clients, follow this for more information about it.
This Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
To be subscribed to Virtual Machine offer
Project Editor or Compute Admin roles in Google Cloud project
A Service Account with Cloud Infrastructure Manager Agent Compute Admin and Service Account User roles
In Google Cloud Marketplace you find this Virtual Machine offer as or look for Ortus Solutions, Corp to look for out full catalog.
Accept Terms and agreements to subscribe to Virtual Machine offer
Deployment config: Set up your deployment with a name, use an existent service account or create a new one for deploying and select the Zone where you want to deploy your virtual machine
Machine type: Select Virtual Machine type and size for your Boot disk
Networking: Select Network, Subnetwork and External IP configuration for your Virtual Machine
Finally select open ports to be available from internet
Once your Virtual Machine is deployed, you can view it from Google Compute Engine console. To connect through SSH, click in SSH button a side of your Virtual Machine. You can copy Private and Public IP to connect you at HTTP (80) port.
When connect through SSH using web console a new window is opened asking for authorize to load your Google Cloud user's SSH keys into virtual machine
If you want to load your own SSH keys or connect to your Virtual Machone with differents SSH clients, follow this for more information about it.



[10:39 AM]-[otisnado@otisnado-ortushp]-[~]-
$ ssh [email protected]
ubuntu@ip-172-31-29-194:~$ubuntu@ip-172-31-29-194:~$ sudo su
root@ip-172-31-29-194:/home/ubuntu# cd /web/coldbox-site/wwwroot/
root@ip-172-31-29-194:/web/coldbox-site/wwwroot# boxWelcome to CommandBox!
CommandBox:wwwroot> coldbox create handler type=index name=helloFromBoxLangCloudServer
INFO Created View [/web/coldbox-site/wwwroot/views/helloFromBoxLangCloudServer/index.cfm]
INFO Created Handler [/web/coldbox-site/wwwroot/handlers/helloFromBoxLangCloudServer.cfc]
INFO Created Integration Spec [/web/coldbox-site/wwwroot/tests/specs/integration/helloFromBoxLangCloudServerTest.cfc]
CommandBox:wwwroot> 






























This Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need to enable Google Compute API and have a project with billing enabled, if not have one follow this link also, you can get 300 USD of credits.
To be subscribed to Virtual Machine offer
Project Editor or Compute Admin roles in Google Cloud project
A Service Account with Cloud Infrastructure Manager Agent Compute Admin and Service Account User roles
In Google Cloud Marketplace you find this Virtual Machine offer as or look for Ortus Solutions, Corp to look for out full catalog.
Accept Terms and agreements to subscribe to Virtual Machine offer
Deployment config: Set up your deployment with a name, use an existent service account or create a new one for deploying and select the Zone where you want to deploy your virtual machine
Machine type: Select Virtual Machine type and size for your Boot disk
Networking: Select Network, Subnetwork and External IP configuration for your Virtual Machine
Finally select open ports to be available from internet
Once your Virtual Machine is deployed, you can view it from Google Compute Engine console. To connect through SSH, click in SSH button a side of your Virtual Machine. You can copy Private and Public IP to connect you at HTTP (80) port.
When connect through SSH using web console a new window is opened asking for authorize to load your Google Cloud user's SSH keys into virtual machine
If you want to load your own SSH keys or connect to your Virtual Machone with differents SSH clients, follow this for more information about it.








This Azure Virtual Machine create a runnging ColdBox Site using BoxLang with bx-compat-cfml module for you. If you do not want a ColdBox site we will show you how to remove it and have your own site. For deploying this Virtual Machine you need a Microsoft Subscription, if not have one follow this link to get 200 USD of credits.
In Azure Marketplace you find this Virtual Machine offer as BoxLang MiniServer with CommandBox and NGINX Ubuntu 24.04 or look for Ortus Solutions, Corp to look for out full catalog.
In the overview product click on create button to start deployment proccess
In Basics tab select your Azure Subscription, resource group and region where Virtual Machine reside. Also, you set here Name, Availability zone, Size, Username and your desired method to login of your Virtual Machine.
Disks tab let you set up additional managed disk for your Virtual Machine, We recommend to add one additional data disk to store your data. If you change a different size for disk read documentation.
In Networking you set up Virtual Network, Subnet, Public IP and Network Security (this can be default or make a custom by you). If Virtual Machine size selected is compatible you can enable Accelerated networking. Also if you plan to deploy this Virtual Machine behind a Load Balancer you can config that from here.
Management tab let you configure Identity for your Virtual Machine, Auto-shutdown, backups and Guest OS update. Currently we are working to support Microsoft Entra ID authentication, but if want to enable out of the box, follow this .
In Monitoring tab you can Alerts, Boot diagnostics and Health monitoring for your Virtual Machine.
In Adavance you can add Extensions, Application or Custom scripts with cloud-init and configuration related to where is located physically your Virtual Machine.
Tags tab let you tagging your virtual machine and dependent resources.
Review + create tab let you see all your configurations and alerts you if any of them need review or change, if not, click on create to deploy your BoxLang with CommandBox Ubuntu 24.04 Virtual Machine.








