Unbedocs

Quickstart

Create a scoped secret set and run a local process with its values injected.

Before you begin

You need an Unbe account and Node.js with npm installed.

Install the CLI

Install
npm install --global unbe-cli
Verify installation
unbe --version

The npm package is named unbe-cli, and it installs theunbe command globally.

Create your secret set

Create a workspace

Sign in to the dashboard and create the team boundary that will own your projects, members, and audit history.

Create a project

Use the name of the app or service you are configuring, such asatlas-api.

Add an environment

Create development first. Add staging and production only when those release lanes exist.

Add secrets

Add the key and value pairs your application expects. Secret keys should match their environment variable names exactly.

Connect the CLI

Terminal
unbe login
unbe use -w acme -p atlas-api -e development
unbe whoami
unbe secrets list

unbe use stores the selected workspace, project, and environment for the current repository. Confirm the resolved identity and target before reading or changing values.

Run your application

Terminal
unbe run -- npm run dev

Everything after -- is the child command. Unbe fetches the selected secret set and adds it to that process environment.

Keep local secrets out of Git

Prefer unbe run for local processes. If you deliberately pull values into a file, ensure that file is ignored before writing it.

Next steps

  • Read the CLI reference for import, pull, set, and watch mode.
  • Review configuration precedence before adding machine tokens.
  • Read the security guide before connecting production automation.

On this page