icp-cli Documentation

Build and deploy applications on the Internet Computer.

Start Here

• Quickstart — Deploy a full-stack app in under 5 minutes
• Tutorial — Deploy your first app step by step

Guides

Step-by-step instructions for common tasks:

• Installation — Install icp-cli on your system
• Local Development — The edit-build-deploy cycle
• Deploying to Mainnet — Go live on the Internet Computer
• Deploying to Specific Subnets — Target specific subnets
• Managing Environments — Dev, staging, production workflows
• Managing Identities — Keys and authentication reference
• Tokens and Cycles — ICP tokens and cycles command reference
• Containerized Networks — Docker-based local networks
• Using Recipes — Reusable build templates
• Creating Recipes — Build custom recipes
• Creating Templates — Author project templates

Concepts

Understand how icp-cli works:

• Project Model — How configuration is organized
• Build, Deploy, Sync — The deployment lifecycle
• Environments and Networks — Deployment targets explained
• Recipes — Templated build configurations

Reference

Complete technical specifications:

• CLI Reference — All commands and flags
• Configuration Reference — icp.yaml schema
• Canister Settings — All settings options
• Environment Variables — CLI and build variables

Additional Resources

• Migrating from dfx — For existing dfx users
• Examples — Sample projects for various use cases