Add File Bundles to Private Images: More Flexibility and Control

By
Adam Clark
January 27, 2026
Share this post

While our Image Creator gives you the building blocks to add custom packages and environment variables to base Minimus images, file bundling adds flexibility by supporting additional use cases for further customization and consolidation of specific organizational files that are often bundled during separate build processes. These files can now be included automatically as part of Minimus image builds.

In this post, we’ll walk through how file bundling works, common use cases, and how to create file bundles inside Minimus Image Creator.

How Teams Use File Bundling With Minimus Images

File bundling is designed for teams that need to include required files in their images without managing separate build logic or one-off Dockerfile changes. It helps standardize what goes into images across teams, environments, and entire fleets, while keeping builds consistent and easy to maintain. 

With file bundling, you can:

  • Automatically upload and bake in organizational certificates or certificates used across an enterprise
  • Bake in configuration files or scripts that an image or sets of images should automatically all across either a particular image or a set of images

How File Bundling Works

File bundling in Minimus is designed to be simple and repeatable, and can be broken down into a few straightforward steps:

  1. Upload one or more files that are labeled as a bundle and maintained within Minimus.
  2. Specify if the file is a certificate or a general file. For each generic file, you have the option to specify the path of where the file will reside on the image.
  3. After a file bundle has been created and uploaded to Minimus, you have the option to reuse the same bundle across any other private image.
  4. New private image builds automatically include the specified bundle that is defined as part of the private image.

How to Create File Bundles in Minimus Image Creator

First, Navigate to Image Creator. 

New bundles may be created prior to creating a private image by clicking “Manage Files”, or during the Image Creation Process by Selecting “Add File Bundle”.

How to Add a File Bundle Prior to Creating a Private Image

Minimus Image Creator interface
Navigate to Minimus Image Creator and select "Manage Files" to create and manage file bundles.

Minimus Image Creator interface showing the “Manage File Bundles” view used to create and manage reusable file bundles.
Select "Upload New Bundle" to add a file bundle.

How to Add a File Bundle During Image Creation Wizard

Minimus Image Creator wizard with an option selected to add a file bundle during private image creation.
You can also add file bundles in the private image creation wizard by selecting "Add File Bundle".

How to Upload New File Bundles

After you create a new file bundle, you can upload files. 

Certificates:

Minimus Image Creator screen displaying certificate files uploaded as part of a file bundle.
Select "certificates" to upload certificates to a file bundle.

Other File Types:

Minimus Image Creator interface showing a default nginx configuration file uploaded to a file bundle.
Select "Other" to upload other file types to a file bundle.

You can also add an existing bundle during the Image Creation process:

Minimus Image Creator showing the File Repository selection used to add an existing file bundle during the image creation process.
Select from File Repository to add existing bundles during the image creation process.

Minimus Image Creator build summary showing selected file bundles that will be automatically included in a private image.
The selected file bundles will appear in your private image build.

After saving the bundles and launching the build, these file bundles will now automatically be included with each private image build and can be reused with other private images.  

Custom Image inside Minimus Image Creator
The uploaded file bundles will now be included in each private image build.

Get Started With File Bundling in Minimus

Extending the Minimus Image Creator functionality by bundling specific organizational certificate requirements and standard configuration files further allows engineering and application teams to adopt minimal package and CVE images while not compromising existing processes and requirements within existing image builds.  

If you’re ready to simplify how required files are managed in your container images, head to Image Creator or get in touch to start using file bundles in your next private image build.

Adam Clark
Principal Solutions Architect
Sign up for minimus

Avoid over 97% of container CVEs

Access hundreds of hardened images, secure Helm charts, the Minimus custom image builder, and more.