Skip to Content

Getting Started

Deploy

SAMURAI ships as a single Docker image that bundles the backend, the web UI, and an embedded MongoDB (external-first, embedded-fallback). See Deployment for the full options.

docker run -d --name samurai -p 80:80 -p 443:443 \
  -v samurai-data:/app/mongo-data \
  beyrak44/samurai:latest

The image is published on Docker Hub:

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 the portal in your browser and sign in with the default credentials.

⚠️

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 validates reachability and starts the first sync.

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

Last updated on