Skip to main content
This guide takes you from a fresh install to running your first commands against a Dynamic environment.
What you need: Node.js 18+ and a Dynamic account. If you don’t have an account yet, create one in the Dynamic dashboard.

​
1. Install

This installs the dyn binary globally. Verify the install:

​
2. Authenticate

The CLI opens your browser, you approve the request from the Dynamic dashboard, and the CLI stores a token locally. Login also auto-selects the first available environment, so your next command works immediately. For CI and automation, skip the browser and set a token instead — see Authentication & CI.

​
3. Check your context

This shows the active organization, project, and environment. Every command that reads or changes data targets this environment until you switch.

​
4. Select an environment

Sandbox and live are fully isolated. Confirm with dyn status that you’re on sandbox before testing changes — running against live affects real users immediately.

​
5. Run your first commands

Discover what’s configurable, then read a value:
Add -o json to any command for machine-readable output:

​
6. Log out

On shared machines, clear your stored token when you’re done:

​
Next steps

Config as code

Export an environment to YAML and apply changes with safety gates.

Project settings

Read and write the settings tree with dyn settings.

Managing embedded wallets

Configure embedded wallet behavior from the terminal.

Authentication & CI

Run the CLI non-interactively in pipelines.

​
Troubleshooting

If a command reports no active environment, run dyn environments switch to select one, then retry. If your token has expired, re-run dyn auth login.
Last modified on June 1, 2026