---
title: "Bundle Management"
description: "Documentation for Bundle Management in ZeyOS SDK CLI"
canonical_url: "https://www.zeyos.com/sdk/bundle-management"
markdown_url: "https://www.zeyos.com/ai/guide/sdk/bundle-management.md"
section: "sdk"
authority: "guide"
language: "en"
source_repository: "zeyos/sdk-v2"
source_path: "docs/bundle-management/index.md"
source_revision: "a99897af74253b4dc5af6fecb9301cea0ae18e27"
---

# Bundle Management

The Bundle Management commands help you create and install bundles of multiple ZeyOS applications.

Available Commands
------------------

| Command | Description | Usage |
|---------|-------------|-------|
| [`create`](https://www.zeyos.com/sdk/bundle-management/zeysdk-bundle-create) | Create new bundle | `zeysdk bundle create [OUTPUT_FILE]` |
| [`install`](https://www.zeyos.com/sdk/bundle-management/zeysdk-bundle-install) | Install bundle to instance | `zeysdk bundle install <BUNDLE_FILE> <INSTANCE_ID>` |

**Process**

1. **Bundle Creation**
   - Scans a parent directory for ZeyOS applications
   - Lets you choose which applications belong in the bundle
   - Writes a bundle file containing the selected app directories

2. **Bundle Installation**
   - Validates unique, contained application directory names from the bundle file
   - Links each app to the target instance
   - Force-pushes each application to the target instance sequentially
   - Reports a nonzero result if any app fails, including when `--force` allowed later apps to run

**Common Workflows**

```bash
zeysdk bundle create release-bundle --all
zeysdk bundle install release-bundle dev-instance --token "$ZEYSDK_TOKEN" --url https://cloud.zeyos.com/dev-instance
```

**Notes**

- `bundle` is a meta command; use `zeysdk bundle create` or `zeysdk bundle install`
- Bundle files store app directory names, not the full application contents
- Run bundle commands from the parent directory that contains the app folders
- Installation is not transactional across apps: an earlier successful remote push is not undone if a later app fails
- Use snapshots when you need a local backup of a single project state