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.

terminal ยท deploy
$ docker pull beyrak44/samurai
latest: Pulling from beyrak44/samurai
Status: Downloaded newer image for beyrak44/samurai:latest
$ docker run -d --name samurai beyrak44/samurai
mongodb (bundled) : ready
api : listening
sync workers : scheduled
dashboard : ready
Setup complete. Visit http://localhost
  1. 01Pull beyrak44/samurai from Docker Hub.
  2. 02Run the container on a single VM. MongoDB is bundled in the image.
  3. 03Open the dashboard and register your first devices.
  4. 04Background sync takes it from there.

What it runs on

Footprint
One container on a single VM.
Database
MongoDB, bundled in the image.
Device access
Read-only: show commands and vendor APIs.
Internet
Optional. Air-gapped deployments are supported.
Vendors
Cisco APIC, FMC, NDO, ISE, Palo Alto, Fortinet, VMware vCenter, routers and switches.

Security posture

Telemetry
None. Nothing phones home.
Credentials
Device credentials encrypted at rest (AES-256).
Perimeter
Runs entirely inside your network. Air-gapped environments supported.
Access control
Role-based permissions with LDAP and SSO integration.

Licensing and 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, with no per-user seats and 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.

See your whole network in about five minutes.

One docker run, self-hosted, air-gap friendly. A free test license, no email required.