> Source: https://docs.nometa.az/v4.8.0/getting-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](https://docs.nometa.az/md/v4.8.0/deployment.md).

```bash
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`](https://hub.docker.com/r/beyrak44/samurai):

> **Note:** Need a license? [Get a free trial license](https://share.exploit.az/go/free-trial-lic),
> 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.)

> **Warning:** 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](https://docs.nometa.az/md/v4.8.0/managing-devices.md) for the add/edit/remove flows and
[Device Onboarding](https://docs.nometa.az/md/v4.8.0/device-onboarding.md) for per-vendor connection requirements.

### Explore

The **Dashboard** summarizes fleet health once the first sync completes. From there, start
with [Features](https://docs.nometa.az/md/v4.8.0/features.md) (endpoints, route search, topology, traffic simulation,
change timeline) and [Settings](https://docs.nometa.az/md/v4.8.0/administration/settings.md) (sync intervals, TLS,
access control, licensing).
