Build and deploy

Install an app from a bundle file

All help topics

Click Upload a bundle on Your apps and services, drop an icp project bundle (an .icp file made with icp project bundle) and click Install: the console deploys it to the engine from your browser.

  1. Open the engine's Your apps and services page and click Upload a bundle. The Build with agents page has the same button under Build it by hand.
  2. In the dialog Install a bundle on your engine, drop the file on Drop your bundle here, or click to browse.
  3. Wait for Analyzing bundle… to finish. Application details shows the name the console will list the app under and the canister it opens at.
  4. Click Install, and keep the tab open while it runs Creating canisters, Installing code, Uploading assets and Live. Minimize tucks a running install into the page header.
  5. At Application is live, click Open app, or close the dialog: the app is on Your apps and services.
Good to know
  • Accepted files: .icp, .tar.gz, .tgz and .tar project bundles. The old zip format can no longer be deployed: rebuild it with icp project bundle.
  • Install only bundles you trust: their software runs on your engine, and their setup runs in your browser with your identity.
  • A bundle with a setup plugin needs Chrome 137 or newer, or Edge.
  • One install runs at a time; another waits until it ends.
  • If it fails, Install failed shows the log, and Try again starts over.
  • Any engine role can install a bundle, once the engine has finished setting up.

More about the same page

Still stuck? Contact support