Canisters
Manage and interact with Internet Computer canisters - Deploy, monitor, and control your smart contracts with advanced filtering and NNS support
The Canisters page in the DFX Dashboard provides a centralized interface for viewing and managing all your canisters across different projects, including both user canisters and Network Nervous System (NNS) canisters. This powerful tool allows you to interact with and monitor your Internet Computer canisters efficiently with full dfx 0.25.0 compatibility.
Overview
The Canisters page displays:
Unified Table
A unified table listing all user and NNS canisters from all your projects
Advanced Filtering
Advanced filtering options to find specific canisters by type, network, or search terms
Visual Indicators
Visual indicators to distinguish between user and NNS canisters
Canister Actions
Direct access to canister management and interaction tools
Canister Types
The dashboard supports two types of canisters:
User Canisters
Your Deployed Canisters
- Canisters deployed by you in your projects
- Full management capabilities available
- Complete control over lifecycle and configuration
- Interactive command interface for all operations
User Canisters
Your Deployed Canisters
- Canisters deployed by you in your projects
- Full management capabilities available
- Complete control over lifecycle and configuration
- Interactive command interface for all operations
NNS Canisters
Network Nervous System
- Network Nervous System canisters (governance, ledger, etc.)
- Special NNS badges and indicators
- Query-only operations for safety
- Available on both local and IC networks
Advanced Filtering
Efficiently manage large numbers of canisters with powerful filtering:
Canister List Table
The table displays essential canister information:
Canister Name
Canister name with NNS badge for Network Nervous System canisters
Type
“User”, “Network Nervous System”, or other canister types
Project Name
Project association (clickable for user canisters, “Network Nervous System” for NNS)
Action
“Canister Actions” button leading to the detail page
Click column headers to sort canisters by name, type, or project for easier management across multiple networks.
Canister Detail Pages
Click any canister to access comprehensive management tools with two main tabs:
User Canister Detail View
Interface:
- Methods Tab: Interactive command interface for canister operations
- Metadata Tab: Comprehensive canister metadata and configuration
Management Actions:
- Top Up, Status, Config, Remove buttons in header
- Full control over canister lifecycle
User Canister Detail View
Interface:
- Methods Tab: Interactive command interface for canister operations
- Metadata Tab: Comprehensive canister metadata and configuration
Management Actions:
- Top Up, Status, Config, Remove buttons in header
- Full control over canister lifecycle
NNS Canister Detail View
Interface:
- Methods Tab: Query-only operations for NNS interactions
- Metadata Tab: System canister metadata and network information
Read-Only Access:
- No action buttons (safety for system canisters)
- Query operations only
Canister Actions
Comprehensive management capabilities for user canisters:
Top Up
Add cycles to keep the canister running
Status
View current status, cycle balance, and health metrics
Config
View and edit canister configuration
Remove
Delete canister (irreversible - use with caution)
The “Remove” action permanently deletes the canister and all associated data. Always ensure you have backups before proceeding.
Command Interface (dfx 0.25.0)
The Methods tab provides direct access to dfx commands with full 0.25.0 compatibility:
Key Features
Updated Commands
All dfx 0.25.0 commands with latest options
Dynamic Interface
Command-specific options appear automatically
Direct Execution
Execute commands directly from the dashboard
Real-time Output
View command results immediately
Available Commands
Command Execution
After execution, view:
- Executed Command: Exact command with timestamp
- Output: Command results and data
- Errors: Detailed error messages if command fails
Canister Status & Configuration
Status Details:
- Controller information and permissions
- Runtime status (Running, Stopped)
- Cycle balance and memory usage
- Performance metrics
Status Details:
- Controller information and permissions
- Runtime status (Running, Stopped)
- Cycle balance and memory usage
- Performance metrics
Configuration Details:
- Canister name and type
- Dependencies and source files
- Build configuration
- Editable settings
Best Practices
Troubleshooting
Additional Resources
IC Canister Development
Complete canister development guide
DFX Commands Reference
Official dfx canister command documentation
Cycles & Computation
Understanding cycles and costs
Network Nervous System
NNS documentation and governance
Ready to manage your digital identities? Continue to the Identities & Ledger page to learn about identity management and ICP operations.