Modal logo
CLI Reference modal app modal billing modal bootstrap modal changelog modal config modal container modal curl modal dashboard modal deploy modal dict modal endpoint modal environment modal image modal profile modal queue modal run modal secret modal serve modal setup modal shell modal skills modal token modal volume modal workspace

CLI Reference

This is the reference for the modal command-line interface, installed alongside the modal Python package.

Commands
modal curl Send an authenticated request to a Modal endpoint.
modal deploy Deploy a Modal application.
modal serve Expose Web Functions with hot-reloading on code changes.
modal shell Run a command or interactive shell inside a Modal container.
modal run Run a Modal function or local entrypoint.

Deployments
modal app Manage deployed and running apps.
modal container Manage and connect to running containers.
modal endpoint Create and manage LLM inference endpoints.

Storage
modal image Manage Images.
modal dict Manage modal.Dict objects and inspect their contents.
modal secret Manage secrets.
modal queue Manage modal.Queue objects and inspect their contents.
modal volume Read and edit modal.Volume volumes.

Onboarding
modal setup Bootstrap Modal's configuration.
modal bootstrap Initialize a sample Modal App.

Configuration
modal workspace Interact with the current Modal Workspace.
modal environment Create and interact with Environments
modal profile Switch between Modal profiles.
modal config Manage client configuration for the current profile.
modal token Manage tokens.
modal skills Install and update Modal's agent skills.

Observability
modal billing View workspace billing information.
modal changelog Fetch release notes from the Modal changelog.
modal dashboard Open the Modal Dashboard in a web browser.