modal app

Manage deployed and running apps.

Usage:

modal app [OPTIONS] COMMAND [ARGS]...

Options:

• --help: Show this message and exit.

Commands:

• list: List Modal apps that are currently deployed/running or recently stopped.
• logs: Show the logs from deployed, running, or stopped apps.
• stop: Stop an app.

modal app list

List Modal apps that are currently deployed/running or recently stopped.

Usage:

modal app list [OPTIONS]

Options:

• --env TEXT: Environment to interact with.

If not specified, Modal will use the default environment of your current profile, or the MODAL_ENVIRONMENT variable. Otherwise, raises an error if the workspace has multiple environments.

• --json / --no-json: [default: no-json]
• --help: Show this message and exit.

modal app logs

Show the logs from deployed, running, or stopped apps.

Examples:

Get the logs based on an app ID:

modal app logs ap-123456

Get the logs for a currently deployed App based on its name:

modal app logs --name my-app

Usage:

modal app logs [OPTIONS] [APP_ID]

Arguments:

• [APP_ID]: Look up any App by its ID

Options:

• -n, --name TEXT: Look up a deployed App by its name
• --env TEXT: Environment to interact with.

If not specified, Modal will use the default environment of your current profile, or the MODAL_ENVIRONMENT variable. Otherwise, raises an error if the workspace has multiple environments.

• --help: Show this message and exit.

modal app stop

Stop an app.

Usage:

modal app stop [OPTIONS] APP_ID

Arguments:

• APP_ID: [required]

Options:

• --help: Show this message and exit.