SentinelsSENTINELS
Docs/Quick Start
Getting Started

Quick Start

Overview

Sentinels provides cryptographic identity and trust verification for autonomous machines. This guide walks you through setup in under five minutes.

Prerequisites

  • •A Sentinels account (request access)
  • •Terminal access (macOS, Linux, or WSL on Windows)
  • •Node.js 18+ (for SDK usage)

Step 1 — Install the CLI

curl -fsSL https://get.sentinels.today | sh

Verify the installation:

sentinels --version

Step 2 — Authenticate

sentinels auth login

This opens your browser for authentication. Once complete, your session token is stored locally at ~/.sentinels/credentials.

Step 3 — Initialize a project

sentinels init --project my-fleet

This generates a sentinels.yaml configuration file containing your project ID and API keys.

Important: Add sentinels.yaml to your .gitignore. Never commit credentials.

Step 4 — Register a device

sentinels register \
  --name unit-001 \
  --model forklift-v2 \
  --serial SN-2026-001

Output:

✓ Device registered
  ID:          clx8f2k...
  DID:         did:sentinels:0x7f3a...b2c1
  Trust Score: 100/100
  Status:      registered

Behind the scenes, Sentinels generates an Ed25519 keypair, derives a decentralized identifier (DID), and initializes the trust score.

Step 5 — Verify firmware (recommended)

sentinels verify firmware \
  --robot unit-001 \
  --version 2.4.1 \
  --file ./firmware.bin \
  --anchor

The --anchor flag stores an immutable proof on Solana. Without it, verification is stored off-chain only.

Next steps

Authentication