---
title: Blossom CLI
url: "/docs/blossom-cli/"
canonical_url: https://docs.blossom88.com/docs/blossom-cli/
markdown_url: https://docs.blossom88.com/docs/blossom-cli.md
summary: Blossom CLI concepts and command reference
categories:
- cli
---

# Blossom CLI

The Blossom CLI gives you a direct, scriptable way to manage Blossom resources
from the terminal.

Create a production login profile, then select it:

```sh
blossom profile:create --name production --login
blossom profile:use --name production
```

Approve in your browser; Blossom saves the login credentials for you. Over SSH,
open the printed URL on your own device. `--no-browser` always skips opening a
browser. New profiles use `https://app.blossom88.com`; set `BLOSSOM_API_URL` for
another deployment. Omit `--name` to use your username, with a numeric suffix if
taken. Completion prints the exact selection command. Creating a profile leaves
the current selection unchanged.

`blossom login --new-profile NAME` also creates a named profile without switching.
Plain `blossom login` renews the selected profile, or creates and selects a
username-based profile when none is selected.

Rename a saved profile and its credentials together:

```sh
blossom profile:rename --from tung --to prod-tung
```

The saved current selection follows a rename; existing destination names are rejected.

Use `blossom --help` for commands and `blossom help:all` for the full inventory.

The CLI expresses Product intent and evidence: Apps, Environments, Services,
Builds, Domains, Capacity, managed Data, Activity, logs, metrics, and Container
shell access.

## Concepts

- [Environment Defaults](/docs/blossom-cli/environment-defaults/) - Set defaults for repeated CLI flags.

## Reference

Use the [CLI Reference](/docs/reference/) for exact command syntax,
flags, and examples.