> For the complete documentation index, see [llms.txt](https://cloud-servers.ortusbooks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cloud-servers.ortusbooks.com/aws/ubuntu-based-images.md).

# Ubuntu Based Images

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.

| Images                  | Status               |
| ----------------------- | -------------------- |
| BoxLang MiniServer      | :white\_check\_mark: |
| BoxLang with CommandBox | :white\_check\_mark: |

## Software and tools installed matrix

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

| **Tool name**                     | **Version installed** | **BoxLang MiniServer**             | **BoxLang with CommandBox**           |
| --------------------------------- | --------------------- | ---------------------------------- | ------------------------------------- |
| CommandBox                        | latest                | :white\_check\_mark:               | :white\_check\_mark:                  |
| BoxLang runtime                   | latest                | :white\_check\_mark:(As OS binary) | :white\_check\_mark:(Into CommandBox) |
| BoxLang MiniServer (As OS binary) | latest                | :white\_check\_mark:               | :x:                                   |
| ColdBox Application               | latest                | :white\_check\_mark:               | :white\_check\_mark:                  |

Due these Cloud Servers are Ubuntu 24.04 LTS based, you can follow this [link](https://aws.amazon.com/marketplace/pp/prodview-s4zvkzmlirbga?sr=0-5\&ref_=beagle\&applicationId=AWSMPContessa) to know more about base software running.

## Environment variables

| **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                         |

## Default site

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

| Server                  | Red Hat like                                                                                           | Debian like                                                                                            | Daemon name        |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ------------------ |
| 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       |

{% hint style="info" %}
If you only place your custom site under `/web/boxlang-site/wwwroot` remember to delete their content before in order to remove the sample ColdBox Application
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cloud-servers.ortusbooks.com/aws/ubuntu-based-images.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.