get-started
Quickstart: store your first secret
Sign in to the web app, create a vault, add a typed secret, optionally share it with a team, and reveal it — every reveal is audited.
Updated Jun 23, 2026
This walkthrough takes you from a fresh sign-in to a stored, shareable, revealable secret. It assumes you have access to a VaultTerm web app — either the hosted SaaS or a self-hosted instance. If terms here are unfamiliar, see Core concepts.
Before you start
- An account in an organization. Individual sign-ups land in a shared default organization; team members are invited into their organization.
- The web app open in your browser.
Steps
-
Sign in to the web app. Open the web app and authenticate. You can sign in with a social login or, for an enterprise organization, your configured identity provider.
-
Create a vault. From the vault area, create a new vault and give it a clear name (for example, “Shared infrastructure”). A vault is the container you grant access to; see Vault overview.
-
Add a secret and choose its type. Inside the vault, add a new secret and pick the type that matches what you are storing — a login, an SSH key, an API key, an env file, a TOTP seed, a payment card, or a secure note. The type determines the fields you fill in. Fill them and save. The full list is in Secret types.
-
(Optional) Share it with a team. If others need this secret, share it with a team rather than naming individuals. Team membership requires organization membership, so sharing stays inside your tenant. Rotation and sharing details are in Sharing and rotation.
-
Reveal the secret. Open the secret and reveal its value when you need it.
A note on revealing
Revealing a secret is a sensitive action, so it is gated and recorded:
- Reveals are audited. Each reveal lands in the tamper-evident audit trail, attributable to you. See Audit logs.
- Social-login sessions require a step-up. If you signed in with a social login, the app asks for an additional WebAuthn proof (a step-up / user-verification check) before it will reveal a sensitive value. This binds the reveal to a hardware-backed presence check on top of your session.
Where to go next
- Set up rotation and sharing policy in Sharing and rotation.
- Connect to a host with a stored secret in Quickstart: open your first session.