Security Setup Wizard

Five-step wizard that configures GPG pinentry, a GPG key, the pass store and an SSH key.

packages/security-setup

Security Setup is a small wizard for a machine that has no GPG key, password store or SSH key yet. It runs the usual gpg, pass and ssh-keygen commands, so the results are ordinary files you can manage by hand. It checks what already exists and lets you skip steps that are done. The larger RobOS Setup Wizard covers the same ground plus git identity, Chrome, GitHub login and AI keys.

Requirements

gpg, pass and ssh-keygen installed. For the pinentry step, one of pinentry-gtk-2, pinentry-qt, pinentry-gnome3 or pinentry at /usr/bin.

The steps

  1. Pinentry. Configure Secure Dialog writes ~/.gnupg/gpg-agent.conf with the first pinentry program it finds, a 24-hour cache (default-cache-ttl 86400, max-cache-ttl 86400) and allow-preset-passphrase, and reloads gpg-agent. This replaces an existing gpg-agent.conf.
  2. GPG Key. If keys exist, choose one with Use Selected Key. Otherwise enter a name, email and passphrase and click Generate GPG Key, which creates a 4096-bit RSA key with no expiry.
  3. Pass Store. Initialize Pass Store runs pass init <key>, creating ~/.password-store.
  4. SSH Key. If ~/.ssh/id_ed25519, id_ecdsa or id_rsa exists you can continue. Otherwise enter a comment and optional passphrase and click Generate SSH Key to create ~/.ssh/id_ed25519 with ssh-keygen -t ed25519. The public key is shown so you can add it to GitHub yourself.
  5. Done. The credentials are in place. Use Pass Manager to work with the store.

Reset in the header deletes the GPG key named in ~/.password-store/.gpg-id, removes ~/.password-store entirely and deletes ~/.gnupg/gpg-agent.conf. The app asks for confirmation first, but stored passwords cannot be recovered afterwards.

Run it

Launch Security Setup from the app launcher, or run npm start in packages/security-setup.

More in Security & Credentials

DocuVault Desktop

Offline-first secure markdown notes, personal snippet vault, and local workstation storage starter app.

Git Login Manager

Checks that GitHub access works (gh login, SSH key, SSH connection, git identity) and walks you through fixing what fails.

Pass Manager Vault

Desktop front end for the standard Unix password store (pass), with entries encrypted by GPG.

Pass Unlock Daemon

Small dialog that asks for your GPG passphrase once a day and caches it in gpg-agent.

RobOS App Mesh

Zero-Trust App & IPC Port Mesh for connecting RobOS applications across machines (mTLS 1.3, OpenZiti, Tailscale, NetBird, WireGuard)

RobOS Cloud Accounts

One list of your cloud accounts, shared with Data Sources and Google Calendar; Google accounts can sign in through the browser and be written into Thunderbird.

RobOS Hardware Keys

YubiKey & FIDO2 physical push keys, touch verification, ed25519-sk SSH keys, Passkeys, and PAM U2F security studio

RobOS Private Networks

Cross-Network Zero-Trust P2P & Relay Mesh for linking RobOS machines across separate networks/NAT/CGNAT via Mutual TLS 1.3 (robos-net://), AES-256-GCM encrypted rendezvous, bidirectional Reverse-Mux tunneling, and cross-machine RobOS Movie Player (:19215) streaming

RobOS Setup Wizard

Eleven-step first-run wizard for GPG, pass, pinentry, git identity, SSH, Chrome, GitHub login, AI agent keys and optional tools.

RobOS VPN Sandbox

Launch any desktop or CLI app inside an isolated Linux network namespace (ip netns) routed exclusively through OpenVPN with a 3-barrier kernel kill-switch.

RobOS VPN Servers

Manage OpenVPN providers (IPVanish built-in with 3,598 server profiles), encrypted VPN accounts, live TLS 1.3 credential tests, and server locations.