Skip to Content
V4.8.0Getting Started

Getting Started

Deploy

SAMURAI Networks ships as a single Docker image (backend, web UI, and embedded MongoDB). This quickstart runs it with defaults; for prerequisites, production secrets, and an external database, see Deployment.

docker run -d --name samurai -p 80:80 -p 443:443 beyrak44/samurai:latest

To keep the database when the container is removed, persist it on the host by adding a volume: -v samurai-data:/app/mongo-data.

The image is published on Docker Hub as beyrak44/samurai:

View beyrak44/samurai on Docker Hub

Need a license? Get a free trial license, then upload it under Settings → License after signing in.

Sign in

Open http://<server-address> in your browser and sign in with the default credentials. (To serve over HTTPS, install a certificate under Settings → Network & Security after signing in.)

⚠️

Default login is admin / admin. Change it immediately after first sign-in (you will be prompted).

Add your first device

Go to Devices → Add Device, choose the device type, and enter its address and credentials. SAMURAI Networks validates reachability and starts the first sync.

See Managing Devices for the add/edit/remove flows and Device Onboarding for per-vendor connection requirements.

Explore

The Dashboard summarizes fleet health once the first sync completes. From there, start with Features (endpoints, route search, topology, traffic simulation, change timeline) and Settings (sync intervals, TLS, access control, licensing).

Last updated on