📦 Bundle

📦 Manage Application Bundles for Déploiement in Capgo Cloud, including Télécharger, compatibility checks, and Chiffrement.

⬆️ Télécharger

Alias: u

npx @capgo/cli@latest bundle upload

⬆️ Télécharger a Nouveau Application Bundle to Capgo Cloud for distribution. Version must be > 0.0.0 and unique. Deleted versions cannot be reused for Sécurité. External Option: Store only a URL link (useful for apps >200MB or privacy requirements). Capgo never inspects external content. Ajouter Chiffrement for trustless Sécurité.

Example:

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production

Options:

Param	Type	Description
-a,	string	Clé API to link to your Compte
-p,	string	Path of the folder to Télécharger, if not provided it will use the webDir set in capacitor.config
-c,	string	Canal to link to
-e,	string	Link to external URL instead of Télécharger to Capgo Cloud
—iv-session-key	string	Set the IV and session key for Bundle URL external
—s3-region	string	Region for your S3 bucket
—s3-apikey	string	Clé API for your S3 endpoint
—s3-apisecret	string	API secret for your S3 endpoint
—s3-endpoint	string	URL of S3 endpoint
—s3-bucket-name	string	Name for your AWS S3 bucket
—s3-port	string	Port for your S3 endpoint
—no-s3-ssl	boolean	Désactiver SSL for S3 Télécharger
—key-v2	string	Custom path for private signing key (v2 system)
—key-data-v2	string	Private signing key (v2 system)
—Bundle-url	boolean	Prints Bundle URL into stdout
—no-key	boolean	Ignore signing key and send clear Mise à jour
—no-code-Vérifier	boolean	Ignore checking if notifyAppReady() is called in source code and index present in root folder
—display-iv-session	boolean	Show in the console the IV and session key used to encrypt the Mise à jour
-b,	string	Bundle Version number of the Bundle to Télécharger
—link	string	Link to external resource (e.g. GitHub Libération)
—comment	string	Comment À propos this Version, could be a Libération Remarque, a commit hash, a commit message, etc.
—min-Mise à jour-Version	string	Minimal Version required to Mise à jour to this Version. Used only if the Désactiver auto Mise à jour is set to metadata in Canal
—auto-min-Mise à jour-Version	boolean	Set the min Mise à jour Version based on Natif packages
—ignore-metadata-Vérifier	boolean	Ignores the metadata (node_modules) Vérifier when uploading
—ignore-checksum-Vérifier	boolean	Ignores the checksum Vérifier when uploading
—timeout	string	Timeout for the Télécharger process in seconds
—multipart	boolean	[Obsolète] Use —tus instead. Uses multipart protocol for S3 uploads
—zip	boolean	Télécharger the Bundle using zip to Capgo cloud (legacy)
—tus	boolean	Télécharger the Bundle using TUS to Capgo cloud
—tus-chunk-size	string	Chunk size in bytes for TUS resumable uploads (default: auto)
—partial	boolean	[Obsolète] Use —delta instead. Télécharger incremental Mises à jour
—partial-only	boolean	[Obsolète] Use —delta-only instead. Télécharger only incremental Mises à jour, skip full Bundle
—delta	boolean	Télécharger incremental/differential Mises à jour to reduce bandwidth
—delta-only	boolean	Télécharger only delta Mises à jour without full Bundle (useful for large apps)
—Chiffré-checksum	string	An Chiffré checksum (signature). Used only when uploading an external Bundle.
—auto-set-Bundle	boolean	Set the Bundle in capacitor.config.json
—dry-Télécharger	boolean	Dry Télécharger the Bundle process, mean it will not Télécharger the files but Ajouter the row in database (Used by Capgo for internal Test)
—package-json	string	Paths to package.json files for monorepos (comma-separated)
—node-modules	string	Paths to node_modules directories for monorepos (comma-separated)
—encrypt-partial	boolean	Encrypt delta Mise à jour files (auto-enabled for updater > 6.14.4)
—Supprimer-linked-Bundle-on-Télécharger	boolean	Locates the currently linked Bundle in the Canal you are trying to Télécharger to, and deletes it
—no-brotli-patterns	string	Files to exclude from Brotli compression (comma-separated globs, e.g., “.jpg,.png”)
—Désactiver-brotli	boolean	Completely Désactiver brotli compression even if updater Version supports it
—Version-exists-ok	boolean	Exit successfully if Bundle Version already exists, useful for CI/CD workflows with monorepos
—self-assign	boolean	Allow Appareils to auto-join this Canal (Mises à jour Canal setting)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo Développement)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🧪 Compatibility

npx @capgo/cli@latest bundle compatibility

🧪 Vérifier compatibility of a Bundle with a specific Canal in Capgo Cloud to ensure Mises à jour are safe.

Example:

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

Options:

Param	Type	Description
-a,	string	Clé API to link to your Compte
-c,	string	Canal to Vérifier the compatibility with
—text	boolean	Output text instead of emojis
—package-json	string	Paths to package.json files for monorepos (comma-separated)
—node-modules	string	Paths to node_modules directories for monorepos (comma-separated)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo Développement)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🗑️ Supprimer

Alias: d

npx @capgo/cli@latest bundle delete

🗑️ Supprimer a specific Bundle from Capgo Cloud, optionally targeting a single Version.

Example:

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

Options:

Param	Type	Description
-a,	string	Clé API to link to your Compte
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo Développement)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

📋 List

Alias: l

npx @capgo/cli@latest bundle list

📋 List all Bundles uploaded for an Application in Capgo Cloud.

Example:

npx @capgo/cli@latest bundle list com.example.app

Options:

Param	Type	Description
-a,	string	Clé API to link to your Compte
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo Développement)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🧹 Cleanup

Alias: c

npx @capgo/cli@latest bundle cleanup

🧹 Supprimer old Bundles in Capgo Cloud, keeping specified number of recent versions. Bundles linked to Canaux are preserved unless —ignore-Canal is used.

Example:

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

Options:

Param	Type	Description
-b,	string	Bundle Version number of the Application to Supprimer
-a,	string	Clé API to link to your Compte
-k,	string	Number of versions to keep
-f,	string	Force removal
—ignore-Canal	boolean	Supprimer Bundles even if linked to Canaux (Avertissement: deletes Canaux too)
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo Développement)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🔒 Encrypt

npx @capgo/cli@latest bundle encrypt

🔒 Encrypt a zip Bundle for secure external storage. Retourne ivSessionKey for Télécharger/decryption. Get checksum using ‘Bundle zip —json’.

Example:

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

Options:

Param	Type	Description
—key	string	Custom path for private signing key
—key-data	string	Private signing key
-j,	string	Output in JSON

🔓 Decrypt

npx @capgo/cli@latest bundle decrypt

🔓 Decrypt an Chiffré Bundle (mainly for Test). Prints base64 session key for verification.

Example:

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

Options:

Param	Type	Description
—key	string	Custom path for private signing key
—key-data	string	Private signing key
—checksum	string	Checksum of the Bundle, to verify the integrity of the Bundle

🔹 Zip

npx @capgo/cli@latest bundle zip

🗜️ Créer a zip file of your Application Bundle. Retourne checksum for use with Chiffrement. Use —json for machine-readable output.

Example:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

Options:

Param	Type	Description
-p,	string	Path of the folder to Télécharger, if not provided it will use the webDir set in capacitor.config
-b,	string	Bundle Version number to name the zip file
-n,	string	Name of the zip file
-j,	string	Output in JSON
—no-code-Vérifier	boolean	Ignore checking if notifyAppReady() is called in source code and index present in root folder
—key-v2	boolean	Use Chiffrement v2
—package-json	string	Paths to package.json files for monorepos (comma-separated)