First boot

What happens the first time you launch the app

What happens the first time you launch OctoMY™ on a brand-new device — and why you don't have to set anything up.

When to use this

  • You just installed the app on a new machine
  • You want to know what's been created on your behalf so you can decide whether to upgrade it to a passphrase-protected identity
  • You're curious why nothing prompted you for a password during install

For the conceptual background — what a Sentient is, what a Hive is, how identity is stored — see Sentient Identity.


What happens automatically

On first launch, StartupStateMachine discovers no existing identity on disk and runs the §SP-1 auto-create branch silently. The app:

  1. Generates a Sentient display name using SentientNameGenerator (libid). The result is an adjective_noun phrase from the existing word lists — something like curious_otter or sunny_crane. You can rename it later from the Sentient Lobby.
  2. Creates a Sentient identity with a fresh Ed25519 keypair. The SID (Sentient Identity hex) is derived from the public key.
  3. Creates a Hive to store the Sentient's vault, contacts, and per-Node hives. The hive's on-disk id is SID-<your-sid-hex>. You never see it; the UI shows the Sentient's display name everywhere.
  4. Mounts the Hive without prompting. This is what the spec calls a Shadow Sentient — an identity that exists on this device but is not protected by a passphrase. The hive is mounted with an internal throwaway secret known only to the app.

There is no wizard, no progress bar, no password prompt during this step. You arrive at the home activity with a working identity already active.


Then the first page

The app then opens its first page. On a HUB that is the node setup wizard, which you can skip. Nothing asks for a passphrase at first boot. Until the first page is up, the splash screen covers the window, and nothing in the window takes a click.

Shadow is fine for development machines, dedicated agent/remote hardware, or any context where the device's own security guarantees are sufficient. Full is the right answer for personal laptops, shared workstations, or anything that might leave your physical control. See Upgrade to a Full Sentient below.


What you'll see in the Lanyard

When the first page is up, the navigation header's Lanyard (top-right corner) shows your newly-created identity:

  • The sentient chip (green border) carries your Sentient's identicon — a face-style pixel art generated deterministically from your SID — and its display name (the adjective_noun phrase if you didn't change it).
  • The node chip (blue border) is initially unbound (No node) until you select or create a node. Click it to open Node Selection.
  • The hive button (bare green hexagon glyph, left of the sentient chip) is visible because your Sentient hive is mounted. Click it to open the Hive Lobby.

The chips' display names update everywhere the app surfaces them (status widgets, OPAL prompts, log lines).


Why no first-boot wizard?

Earlier versions of OctoMY™ ran a multi-step Unboxing Wizard on first launch: pick a passphrase, generate keys, choose a name. The current spec (the internal Startup Identity Unification spec) replaced that wizard with the silent §SP-1 auto-create path because:

  • A fresh device with no identity is always in a known starting state. The wizard's questions had no real branch — every user clicked through the same options.
  • Forcing a passphrase up front discouraged users from trying the app at all. Shadow-by-default lets the user evaluate the app first and upgrade when they're invested.
  • Skipping a wizard cuts the time-to-running from minutes to under a second.

The Shadow → Full upgrade is reachable from the Sentient Lobby, whenever you want it.


Upgrade to a Full Sentient

Open the Sentient Lobby: click your sentient chip in the Lanyard. Then choose Upgrade to full. The upgrade has four steps:

  1. Name. Keep the name, or type a new one. Press Enter.
  2. Passphrase. Type a passphrase of at least 20 characters. Below 30 characters, it must mix three of: lowercase, uppercase, digits and other characters. Type it again in the second field. Press Enter.
  3. Recovery phrase. Write the twelve words down, in their order, and keep them safe. Choose I have written them down.
  4. Verify. Type the words back. Choose Verify and secure.

Nothing changes until the last step passes. Back goes one step back and keeps what you typed. Back on the first step cancels, and the sentient stays a Shadow. When the upgrade ends, the app asks for the passphrase at each launch.

Write the recovery phrase down. Without it, a forgotten passphrase is unrecoverable.

If the sentient came from another device with a network transfer, the passphrase step asks for the passphrase of that device instead, and the recovery-phrase steps do not show. Choose a new passphrase instead switches to the four steps above.

To bring an identity from another device, use the Sentient Lobby's Import entry. See Migrate an Identity (when authored) for the full restore flow. An imported identity arrives as a Shadow, and your active identity does not change. Switch to it, then upgrade it from its lobby.


Topic Why it's relevant
Sentient Identity What a Sentient is — Shadow vs Full, SID derivation, hive storage
Switch Sentient Move between multiple Sentients on the same device
Switch Node Pick a Node within the active Sentient
Identity Switching What the six-phase switch actually does

In this section
Topics
howto identity sentient first-boot getting-started beginner-friendly
See also