Documentation

From docker run to full visibility.

Everything an evaluator needs before the demo: how to deploy SAMURAI, what it runs on, and how licensing works. No sales call required to get started.

Quick start

The entire install is one container. Pull the image, run it, open the dashboard — a typical deployment is serving data in about five minutes.

  1. 01Pull beyrak44/samurai from Docker Hub
  2. 02Run the container on a single VM — MongoDB is bundled
  3. 03Open the dashboard and register your first devices
  4. 04Background sync takes it from there
terminal · deploy

What it runs on

FootprintOne container on a single VM
DatabaseMongoDB, bundled in the image
Device accessRead-only: show commands and vendor APIs
InternetOptional — air-gapped deployments supported
VendorsCisco APIC, FMC, NDO, ISE, Palo Alto, Fortinet, VMware vCenter, routers & switches

Security posture

TelemetryNone — nothing phones home
CredentialsDevice credentials encrypted at rest (AES-256)
PerimeterRuns entirely inside your network; air-gapped environments supported
Access controlRole-based permissions with LDAP/SSO integration

Licensing & pricing

Evaluation is free: a test license ships with the Docker Hub image, no email required. Production licensing is per-deployment, sized by device count — request a quote and you will typically have it within 24 hours.

Evaluation

  • Free test license, no email required
  • Full feature set, on your real devices
  • Self-hosted — your data never leaves your perimeter

Production

  • Per-deployment license, sized by device count
  • No per-user seats, no usage metering
  • Quote typically within 24 hours

Common questions

How much does SAMURAI cost?

Evaluation is free: a test license ships with the Docker Hub image, no email required. Production licensing is per-deployment and sized by device count — no per-user seats, no usage metering. Request a quote via the contact form; replies typically arrive within 24 hours.

Is there a free version of SAMURAI?

There is a free test license for evaluation, available on the Docker Hub page with no email required. It runs the full feature set on your real devices. Production use requires a per-deployment license.

How long does deployment take?

A typical deployment is serving data in about five minutes: one docker run on a single VM, MongoDB bundled in the image.

Does SAMURAI modify my devices?

No. Device access is read-only — show commands over SSH and read calls on vendor APIs. SAMURAI observes and reports; it never pushes configuration.

What data leaves my network?

None. SAMURAI is fully self-hosted with no telemetry, and runs in air-gapped environments with an offline IEEE OUI database.

Deep dives

The engineering behind the platform, written by the people who built it.

Deploying SAMURAI in air-gapped environments9 min read →How we detect changes without relying on audit logs8 min read →Correlating 13,000 endpoints without a CMDB10 min read →APIC clustering: failover without the flapping7 min read →