Commands

onmcu login

Store an OnMCU API key in the operating system keyring.

onmcu login prompts for an API key and saves it in the operating system keyring:

onmcu login

Create or retrieve the key at app.onmcu.com/settings. The CLI validates the key's structure before storing it.

Replace the current key

If an entry already exists, the command leaves it unchanged and asks you to use --relogin:

onmcu login --relogin

The short form is also available:

onmcu login -r

Headless environments

login requires a supported OS keyring. For CI or a headless system without a Secret Service provider, skip login and pass an API key through the environment:

export ONMCU_API_KEY='your-api-key'
onmcu list-boards --api-key-from-env

See Authentication for keyring requirements and secret-handling guidance.

On this page