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
- Pinentry. Configure Secure Dialog writes
~/.gnupg/gpg-agent.confwith the first pinentry program it finds, a 24-hour cache (default-cache-ttl 86400,max-cache-ttl 86400) andallow-preset-passphrase, and reloadsgpg-agent. This replaces an existinggpg-agent.conf. - 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.
- Pass Store. Initialize Pass Store runs
pass init <key>, creating~/.password-store. - SSH Key. If
~/.ssh/id_ed25519,id_ecdsaorid_rsaexists you can continue. Otherwise enter a comment and optional passphrase and click Generate SSH Key to create~/.ssh/id_ed25519withssh-keygen -t ed25519. The public key is shown so you can add it to GitHub yourself. - 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.