Wardengate
Quickstart

Your first privileged session

This narrative walks from a fresh install to a brokered SSH session with recording and audit metadata — the minimum path to prove value before a wider rollout.

What you need

A Linux VM or Kubernetes cluster for the control plane, one SSH target reachable from the gateway connector, and an IdP (Okta, Azure AD, or local accounts for lab). Helm or Docker Compose handles the install; no agents on targets.

What success looks like

An operator authenticates with their own identity, requests or uses a grant to the target, completes MFA at connect time, and works in a normal SSH client — while Wardengate records the session and writes structured metadata you can search and export.

Step by step

Five steps to a brokered session

  1. 01

    Deploy the control plane

    Install with Helm or Docker Compose following the getting-started guide. Verify the API and admin console are reachable. Create your organization and connect your IdP — or enable local admin for lab use.

  2. 02

    Register a gateway connector

    Deploy a connector node in the same network as your SSH target. The connector registers with the control plane and advertises supported protocols. Health checks confirm it is ready to broker.

  3. 03

    Onboard your first target

    Add the SSH host as an asset — hostname, port, and optional account mapping. Tag it by environment (prod, staging) for policy scoping. No agent install on the target.

  4. 04

    Create an authorization grant

    Bind your operator group to the asset with SSH allowed. For lab, a standing grant is fine; production should use JIT with approvers. The grant is the only path to the target — not VPN or security group membership alone.

  5. 05

    Connect and verify evidence

    Open your SSH client through Wardengate (CLI or web terminal). Complete step-up MFA. Run a few commands, disconnect, then open the session audit view — confirm recording playback, command log, identity attribution, and export-ready metadata.

Operational docs

Ready to deploy? Continue in documentation

Ready to evaluate?

See the platform on your architecture

Walk through gateway brokering, recording, and audit exports in a working session — or start with the interactive demo.