boomi/atom
The Boomi Atom Docker image includes:
The Docker image does NOT include the Boomi runtime itself, only the installer. The installer downloads and installs the Boomi runtime as part of the container creation. Once installed, the Boomi runtime is self-updating from the Boomi Platform. You do not need to update the Docker image to obtain the latest Boomi Runtime release. The Docker image is updated when there are changes to how the container runs in your environment, or to apply security patches and updates to the Linux OS or Java.
Note: You must have a valid Boomi account to use this image. To sign up for a 30-day free trial account, visit Boomi.com.
NoteAs of March 2025, runtime related terminology is updated to be more intuitive and better align with common industry concepts. Specifically “atom” is now “basic runtime”, “molecule” is now “runtime cluster”, and “cloud molecule” is now “runtime cloud cluster.” Throughout the Boomi application and product documentation you will see the use of these new terms, however this image name, environment variables, and other technical values will continue to use the previous terms for backward compatibility.
WarningAs of February 8, 2025 the version 3 and version 4 images are retired and are no longer supported or maintained. Customers still using these versions should upgrade to the latest version (version 5). For details on this retirement and how to upgrade, refer to this Knowledge article.
Boomi runtime Docker images follow the semantic versioning represented by MAJOR.MINOR.PATCH:
The current supported version is tagged with "release". Images are not tagged with "latest" to force a more disciplined approach to versioning.
You can specify the OS and version to use:
Boomi recommends using the release
or release-rhel
version when installing your containers to easily obtain the latest published image.
Note: Customers needing to connect to SAP systems using the SAP or SAP JCo V2 Connectors should use the version 5 Red Hat image. The SAP JCo library used by the connector is incompatible with Alpine. Customers using version 3 should upgrade to version 5 to take advantage of a number of enhancements and security updates. See upgrade notes below.
Boomi supports the latest release
and release-rhel
tag for the current major version. If you experience any issues, be sure to update to the latest release to verify the issue before contacting support.
Important: Upon the availability of a new major version, the previous major version will be deprecated. When deprecated, the previous major version will continue to be supported and maintained (for example, quarterly Java updates, security patches, critical defects, but not minor defects nor enhancements) until its retirement date. After a minimum of six months, the previous major version will be retired after which it will no longer be supported or maintained.
Refer to the Boomi feature deprecation process for more information.
The current major version is 5.
As of February 8, 2025 the version 3 and version 4 images are retired and are no longer supported or maintained. Customers still using these versions should upgrade to the latest version (version 5). For details on this retirement and how to upgrade, refer to this Knowledge article.
See Runtime Docker Image Changelog.
You can install the container with either Docker or Docker Compose.
Generate a new install token via the Boomi Platform UI or Platform API.
Run the following Docker run command with appropriate environment variables. The minimum required variables are included here which are typically sufficient for most installs. See Environment Variable Reference below for the full list.
docker run -p 9090:9090 -h <runtimeName> -e INSTALL_TOKEN=<installerToken> -e BOOMI_ATOMNAME=<runtimeName> -e ATOM_LOCALHOSTID=<runtimeName> --name <runtimeName> -v <hostDirectory>:/mnt/boomi:Z
-d boomi/atom:<version>
Recommendations:
<runtimeName>
is the arbitrary user-defined name for your runtime. We recommend using the same value for the runtime name, local host ID, Docker container name (--name
), and Docker container hostname (-h
) for consistency.
We recommend setting the version to release
or release-rhel
to use the latest available image version.
We recommend using the INSTALL_TOKEN variable for authentication with the Boomi Platform but alternatively you can use the BOOMI_USERNAME, BOOMI_PASSWORD, and BOOMI_ACCOUNTID variables.
If you do not already have a local copy of the image, this command pulls the image automatically.
After the command runs, the installer connects to the Boomi platform to authenticate your credentials. If authentication is successful, the runtime is created and the necessary files are installed. The runtime starts and runs as a daemon thread.
Generate a new install token via the Boomi Platform UI or Platform API.
Create a Docker Compose file (see example below) and populate the variables for your account. See Environment Variable Reference below.
Run the following command:
docker-compose -f compose.yml up
Example compose.yml for runtime installation.
services:
atom:
image: boomi/atom:<version>
container_name: <runtimeName>
volumes:
- <hostDirectory>:/mnt/boomi:Z
environment:
- BOOMI_ATOMNAME=<runtimeName>
- INSTALL_TOKEN=<installerToken>
- ATOM_LOCALHOSTID=<runtimeName>
ports: [9090:9090]
Note: We recommend using the INSTALL_TOKEN variable for authentication with the Boomi Platform but alternatively you can use the BOOMI_USERNAME, BOOMI_PASSWORD, and BOOMI_ACCOUNTID variables.
You can adjust the configuration of your local runtime by passing one or more environment variables as part of the docker run
command. Include additional environment variables in the Docker command line using the -e
flag, or include in the environment section in the Docker Compose file.
If, after using the docker run command, you receive an error about access to the mounted path, ensure that the mounted host directory has been given read, write, and execute permissions to UID 1000. Then, use the docker run command again with the environment variable VALIDATE_MOUNT_ACCESS
set to false.
The SAP connector and the SAP JCo V2 connector are not compatible with the version 4 images. If you need to connect to your SAP systems, use the version 5 RHEL images instead.
If you want to incorporate the Boomi installer into your own custom image, you can download the source code for the image from Bitbucket. This may be desired if you want to use a different Linux OS distribution, include additional environment variables for security purposes, or package Boomi alongside other applications for example. Note that you are responsible for maintaining and keeping your custom image up to date with the latest source code from Boomi.
When a new image version is published, you need to upgrade your container to use that new version. Upgrading involves removing the previous container image and installing the new container image pointed to the same installation directory.
docker stop <container name>
docker rm <container name>
release
or release-rhel
to retrieve the latest available image.docker run -p 9090:9090 -h <runtimeName> -e BOOMI_ATOMNAME=<runtimeName> -e ATOM_LOCALHOSTID=<runtimeName> --name <runtimeName> -v <hostDirectory>:/mnt/boomi:Z -d boomi/atom:<version>
docker-compose down
Review the original compose.yml file to adjust the version, and other environment variables, if necessary (see upgrade considerations below). CRITICAL: Be sure to use the same environment variable values as used for the original container installation (BOOMI_ATOMNAME, ATOM_LOCALHOSTID, name, and hostDirectory).
Run the following command with the compose.yml file:
docker-compose -f compose.yml up
There are no changes to the Docker install command or environment variables.
Version 4 only offered an Alpine image. To continue to use Alpine, set the version to release
. To switch to Red Hat, set the version to release-rhel
.
The version 5 image includes a number of changes to simplify the installation and configuration of the container image. One important consideration is whether to use the Alpine or Red Hat image. Review the upgrade notes below.
If your integrations involve connecting to SAP applications using either the SAP connector or SAP JCo V2 connector, you must use the Red Hat version 5 image (version = release-rhel
). The Alpine image does not support the SAP connectors.
If the DOCKERUID environment variable was previously used and set to a value other than 1000 (not common), manual intervention is required prior to upgrading. Because the newer images are run with a non-root user with a hardcoded UID and GID of 1000, the mounted path where installed runtime files reside must be recursively updated to have an owner of UID 1000.
Privileged mode is no longer necessary. The --privileged
and --tmpfs
flags are no longer used and should be removed from the Docker run command or Docker compose file. Also the mount to /sys/fs/cgroup
should be removed.
The following environment variables are no longer used and should be removed from the Docker run command or Docker compose file: BOOMI_CONTAINERNAME, DOCKERUID, HOST_INSTALLATION_DIRECTORY, INSTALLATION_DIRECTORY, SYMLINKS_DIR, and SECURITY_CRON.
Custom images: If upgrading a custom image using the Boomi image source and looking to switch from Red Hat to Alpine OS, you will need to make appropriate changes to your custom image to account for the switch from Red Hat Enterprise Linux Universal Base Image (RHEL UBI) to Alpine.
docker pull boomi/atom