Bundle Management

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

Available Commands

Command	Description	Usage
create	Create new bundle	zeysdk bundle create [OUTPUT_FILE]
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