> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/support-us/verifone-hq/vhq-software-management/v-os-bundle.md).
# V/OS Bundle
This section discusses the V/OS Bundle in VHQ.
Keywords
Also called: bundle of bundles, V/OS packaging. Search terms: control file, bundle container, secure installer.
## What is a V/OS Bundle?
A V/OS bundle is a collection of one or more packages, signed and downloaded as a single unit on V/OS-based devices. It's simply an archive containing one or more signed packages (optionally including signer certificates and a special *Remove* file). In the example below, there are 2 bundles — Bundle1.TGZ and Bundle2.TGZ — each with a corresponding signature file (.p7s).
Multiple bundles are further compressed and wrapped in a bundle container (BundleContainer.TGZ) to form a bundle of bundles, which can contain one or more bundles.
A single bundle or bundle of bundles can be imported into VHQ and set up as a VHQ package. The contained V/OS packages (Package1.tar and Package2.tar) are extracted and set up as VHQ applications. Control File#1 defines the bundle name and version of Bundle1.TGZ; Control File#1.1 and Control File#1.2 define the package name and version for Package1.tar and Package2.tar, respectively.
Bundles are built by the corresponding SE (Sales Executive) using *Secure Installer*.
## Structure of bundle of bundles (V/OS based devices)
{% hint style="info" %}
* A V/OS bundle is configured as a package in VHQ, and a package contained in the bundle is configured as an application.
* For devices enabled for [automated download](https://verifone.cloud/docs/verifonehq-application/automated-downloads), VHQ downloads bundles that don't match the bundles on the device. Bundle name and version, as defined in the control files, form the basis for evaluating the software version set up on VHQ — only bundles with control files qualify for automated downloads.
* Only VHQ packages qualified for automated download are available when creating a reference set.
{% endhint %}
## Related topics
* [Software package](/support-us/verifone-hq/vhq-software-management/software-package.md)
* [VPI Package](/support-us/verifone-hq/vhq-software-management/vpi-package.md)
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.verifone.com/support-us/verifone-hq/vhq-software-management/v-os-bundle.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
