deploy-to-cloud-engine

Deploys built Internet Computer projects to a cloud engine subnet via the icp CLI.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/phukrit7171/Relationship-Smart-Contract-ICP --skill deploy-to-cloud-engine-phukrit7171
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy-to-cloud-engine
Source: https://github.com/phukrit7171/Relationship-Smart-Contract-ICP/tree/main/.agents/skills/deploy-to-cloud-engine
Command: npx skills add https://github.com/phukrit7171/Relationship-Smart-Contract-ICP --skill deploy-to-cloud-engine-phukrit7171

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying an Internet Computer project to a user-owned cloud engine requires linking the icp CLI to the engine console identity, targeting the correct subnet, and handling sandboxed environments where browser sign-in cannot reach the CLI — steps that fail silently or with authorization errors when done wrong. ## Core Features & Use Cases - Identity Linking: Link the icp CLI to the engine console identity with icp identity link web, including a delegation handoff flow for remote sandboxes where the browser cannot reach the CLI's 127.0.0.1 callback. - Subnet-Targeted Deploy: Run icp deploy -e ic --subnet <subnet-id> against the engine's subnet, with guidance on obtaining the subnet id from the console. - Console App Metadata: Tag canisters with __META_* environment variables so the console groups them into a named app with labels, an icon, and an Open button, plus bake version metadata (service:git:sha, service:version) into the wasm. - Cross-Subnet Proxy: Route cycle-bearing cross-subnet calls (exchange-rate canister, threshold ECDSA/Schnorr, vetKD) through a funded proxy canister, since CloudEngine subnets forbid them directly. - Use Case: An agent in a cloud sandbox needs to ship a user's built IC project to their OpenCloud engine — it creates a delegation request, the user signs it locally, and the agent deploys with proper app naming and version metadata. ## Quick Start Ask the assistant to deploy your built Internet Computer project to your cloud engine, providing your engine's subnet id from the console's App Center page.

Frequently Asked Questions about deploy-to-cloud-engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an Internet Computer project to a cloud engine?

Link the icp CLI to your engine console identity with `icp identity link web <name> --auth <console-origin>`, set it as default, then run `icp deploy -e ic --subnet <subnet-id>`. The subnet id is shown on your engine's App Center / Applications page in the console.

Why does icp identity link web never complete in a sandboxed environment?

The sign-in redirects to 127.0.0.1 on the machine where the CLI runs, so a browser on a different machine cannot reach it. Use the delegation handoff: `icp identity delegation request` on the CLI host, `sign` on the user's machine, then `use` on the CLI host.

How do I name my app and add an icon in the OpenCloud console?

Set `__META_PROJECT`, `__META_NAME`, and `__META_MAIN_CANISTER` environment variables on your canisters, plus `__META_BASE_URL` and `__META_ICON_PATH` on the main canister. The console groups canisters sharing the same `__META_PROJECT` value into one named app.

Can a cloud engine canister call the exchange-rate canister or threshold ECDSA directly?

No. CloudEngine subnets forbid cross-subnet calls that carry cycles or require guaranteed responses. Route these calls through a funded proxy canister deployed on a normal Application subnet, passing the target, arguments, and cycles in ProxyArgs.

What icp CLI version is required for the delegation handoff?

The delegation handoff needs `icp identity delegation`, available in icp-cli 1.0.x. The skill's other commands are verified against icp-cli 0.3.0 and 1.0.2; confirm flags with `icp <subcommand> --help` on your installed version.

When should I not use this deployment approach?

Do not use it for a general mainnet deploy with no engine or subnet — use the plain icp-cli workflow instead. It also does not cover writing canister logic, and it cannot help when the CLI host has no network access at all.