> For the complete documentation index, see [llms.txt](https://docs.vega365.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vega365.com/surestream/management-client/first-time-setup.md).

# First-Time Setup

The setup takes you through choosing the cameras, how SureStream logs in to them, how they stream, and adding them. Each camera is tested before it is added, and only cameras that pass are added.

{% hint style="info" %}
**Nothing in the configuration changes until you click Add on the Add cameras step.** Cancel before that leaves everything as it was. After cameras are added, they stay added even if you close the setup.
{% endhint %}

Start it from the dashboard: **Get started** before SureStream is set up, or [Clean slate](https://docs.vega365.com/surestream/management-client/settings.md#clean-slate) to start over. The same steps, for only the cameras you choose, run when you [add cameras from the dashboard](https://docs.vega365.com/surestream/management-client/camera-dashboard.md#adding-cameras).

The steps are listed on the left. A green check marks a step that is done; a step that isn't needed for your choices is greyed out and marked *Not needed* (for example **Multicast addresses** when every camera streams unicast only).

{% stepper %}
{% step %}

### Cameras

Click **Fetch the camera list**. SureStream reads the list of cameras from XProtect (and its child sites, which ask you to sign in). No camera is contacted or changed.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-dba77235337549d18ee81e5fddbf383ac6719926%2Fmc-setup-01-cameras-fetch.png?alt=media" alt=""><figcaption></figcaption></figure>

The cameras are listed by recording server. Tick the cameras to stream directly to Smart Clients; ticking a recording server ticks all its cameras. Use the search box to find cameras by name, address or recording server.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-55d60265760a034eb8efce786faf796af721f092%2Fmc-setup-02-cameras-picked.png?alt=media" alt=""><figcaption></figcaption></figure>

The line above the list says how many camera devices you can license, for example **Up to 16 devices can be licensed (10 selected)**. One licence covers all channels of a device. When all licences are used, you can't tick cameras on another device.
{% endstep %}

{% step %}

### Camera access

Choose the ONVIF account SureStream uses with each camera, group by group. Each group is **tested as soon as you choose its login**.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-3357a987d5d38a332a7e5664ee300a1a4284d61a%2Fmc-setup-03-camera-access.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Tick a group of cameras (a recording server ticks all its cameras).
2. Click **Choose the login and test** and pick one of the choices below, then **Set and test**.
3. Fix any camera that refuses its login or can't be reached (tick it to see why), then do the next group.

A green check means the camera accepted its login; a red cross means it refused it or couldn't be reached; an amber mark means it has no login yet or hasn't been tested.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-d587b2f12d7727e61342484be77089add2a81618%2Fmc-setup-04-camera-access-tested.png?alt=media" alt=""><figcaption><p>One camera couldn't be reached: tick it to see why</p></figcaption></figure>

**Continue** goes on with the cameras that accepted their login. The others are left out (the footer says how many); fix them and test them again to include them, or add them later from the dashboard.

#### The Camera access choices

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-a71de77ba2464e22ce0d9e6c187592fadeaac307%2Fmc-dialog-camera-access-same.png?alt=media" alt=""><figcaption><p>Same account as XProtect</p></figcaption></figure>

| Choice                                                                 | When to use it                                                                                                                                             | When the password changes                                                                                           |
| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Same account as XProtect**                                           | XProtect uses its **ONVIF driver** for the camera, so the camera has one ONVIF account used by both.                                                       | Change it in XProtect, then select the cameras on the dashboard and click **Sync with XProtect**.                   |
| **Its own ONVIF account** – *I change its password myself*             | XProtect uses a universal or the camera maker's own (native) driver, or you want SureStream kept separate. Enter the **ONVIF user name** and **Password**. | When you change it on the camera, enter the new one in SureStream too (dashboard, right-click > **Camera access**). |
| **Its own ONVIF account** – *Keep its password the same as XProtect's* | As above, but SureStream keeps the account's password the same as XProtect's. Needs Administrator rights on the camera.                                    | **Sync with XProtect** sets XProtect's new password on this account (you confirm first).                            |

The dialog draws how each choice works:

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-e180f1da288588e7d405b1c1795524caf654877d%2Fmc-dialog-camera-access-own.png?alt=media" alt=""><figcaption><p>Its own ONVIF account, password changed by you</p></figcaption></figure>

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-60d86eaac7732a7560994b285a279926a47ce2d5%2Fmc-dialog-camera-access-synced.png?alt=media" alt=""><figcaption><p>Its own ONVIF account, password kept the same as XProtect's</p></figcaption></figure>

{% hint style="warning" %}
**ONVIF rights.** SureStream creates a streaming profile on each camera, so its ONVIF user must be allowed to change the camera's streaming settings. That is usually an **Administrator**; on some cameras (such as Axis) an Operator is not enough. A login without these rights fails its test with *not enough rights*, and the camera's status says what to do. See [ONVIF rights needed](https://docs.vega365.com/surestream/management-client/fixing-camera-problems.md#onvif-rights-needed).
{% endhint %}
{% endstep %}

{% step %}

### Streaming

Choose how Smart Clients receive video. SureStream streams directly from the cameras to the Smart Clients, bypassing the recording server.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-e45fdc1211881d43b530e201b607b11f3e7a374b%2Fmc-setup-05-streaming.png?alt=media" alt=""><figcaption></figcaption></figure>

| Mode                                               | What it does                                                                                                                                                                                                                                            |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Multicast, with unicast fallback** (Recommended) | A camera that supports multicast over ONVIF is set up for multicast and unicast, the others for unicast. Smart Clients that can receive multicast share its one stream; the others (for example over VPN or routed links) get their own unicast stream. |
| **Multicast only**                                 | Every Smart Client joins the camera's multicast stream. A camera that doesn't support multicast over ONVIF is not set up. The network must forward multicast to all Smart Clients (IGMP on the switches and routers).                                   |
| **Unicast only**                                   | Each Smart Client gets its own stream from the camera. Works on any network, but a camera can send only a few streams at once (often 4 to 10, by model), which limits how many Smart Clients can view it at the same time.                              |

To give cameras different modes, choose **A mode per camera**: tick cameras, choose their mode and click **Apply**. Every camera needs a mode before you can continue.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-b9864ba66e5b2c6cfb7a41f33fd82886868e5cb0%2Fmc-setup-05b-streaming-per-camera.png?alt=media" alt=""><figcaption></figcaption></figure>

You can change a camera's mode later in [Settings > Network](https://docs.vega365.com/surestream/management-client/settings.md#network) or from the dashboard (right-click > **Network**).
{% endstep %}

{% step %}

### Multicast addresses

Each camera that streams multicast gets its own multicast address and port from a block. Keep the block small and clear of other multicast traffic on your network.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-b0c95e094c788d77f2c76b02c711829f8ed12f2e%2Fmc-setup-06-multicast.png?alt=media" alt=""><figcaption></figcaption></figure>

* **Use suggested** fills in a block for the selected cameras with room to grow (starting at 239.192.10.10, port 10000).
* Addresses must be between **239.0.0.0 and 239.255.255.254** (multicast for use within an organisation).
* Ports must be **even**, from 1024 to 65534: each stream also uses the next odd port (RTCP).
* Tick **Use a range of ports** to give cameras different ports as well as different addresses. Cameras may share an address on different ports.
* The green line says how many cameras the block has room for.

To give groups of cameras their own blocks (for example one per recording server or building), choose **A block per group of cameras**, tick a group and fill in its block. A block may not share an address and port with an earlier one.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-0d4475053495f6f6e560596b34ff69082dc3a25c%2Fmc-setup-06b-multicast-per-group.png?alt=media" alt=""><figcaption></figcaption></figure>

This step is skipped when no camera will stream multicast.
{% endstep %}

{% step %}

### Multicast quality (optional)

The size of SureStream's multicast stream from each camera. Leave it at **Same as XProtect** unless the multicast picture smudges.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-9c7e56f20214e0ac5111918054c9a5469018f091%2Fmc-setup-07-quality.png?alt=media" alt=""><figcaption></figcaption></figure>

| Quality                        | Stream                                                                                                   |
| ------------------------------ | -------------------------------------------------------------------------------------------------------- |
| **Same as XProtect**           | The stream XProtect gets from the camera: its size, frame rate and bitrate.                              |
| **Medium (about 1 megapixel)** | The camera's own shape kept (16:9 1280x720, 4:3 1152x864, fisheye 1024x1024), the bitrate in proportion. |
| **Low (about 0.3 megapixel)**  | The camera's own shape kept (16:9 640x360, 4:3 640x480, fisheye 544x544), the bitrate in proportion.     |

Why only multicast: a multicast stream is shared by every Smart Client and sent over UDP, so a packet the network loses isn't sent again, and a camera's large keyframe bursts can smudge the picture. Unicast streams go over TCP, which sends lost packets again. Click **Skip** to keep every camera the same as XProtect. XProtect's own stream is never changed.
{% endstep %}

{% step %}

### Add cameras

SureStream tests each camera (network, ONVIF login, video profile and clock). The line above the list shows how many are ready and how many licences are needed.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-fcad7fe7515ff7b10266213abf0beb60de21c53e%2Fmc-setup-08-add.png?alt=media" alt=""><figcaption></figcaption></figure>

* A camera that doesn't pass shows why; select it to see how to fix it. Fix it and click **Test it again** (or **Test the N again**). Cameras with a clock problem get a **Fix time on N cameras** button (see [Fix time](https://docs.vega365.com/surestream/management-client/fixing-camera-problems.md#time-out-of-sync)).
* Click **Add N cameras**. The cameras that passed are tested once more and then added: SureStream creates a streaming profile named **SureStream\_1** (by channel) on each camera and gives it its multicast address. A window shows the progress; the configuration is saved as it goes.
* The cameras that didn't pass don't hold up the others. Fix them and add them here, or later from the dashboard.

When the cameras now in SureStream would be replaced (for example after Get started on a configured site), SureStream asks first and removes the old cameras' SureStream profiles.
{% endstep %}

{% step %}

### Mirroring and rotation (optional)

Only for cameras mounted upside down or on their side, or whose picture comes out mirrored. Because SureStream streams straight from the camera, XProtect's own rotation settings don't apply to it.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-b1f037f082fb4e67fc39f8df26f11b95e48fcb1b%2Fmc-setup-09-mirroring.png?alt=media" alt=""><figcaption></figcaption></figure>

Tick cameras, choose **Mirror** (Off/On) and **Rotation** (0°, 90°, 180°, 270°) and click **Apply to selected**. The preview shows the result. For PTZ cameras, **PTZ controls** follow the video by default (**Same as video**); choose **Own setting** to turn the pan and tilt controls differently. Click **Skip** if no camera needs it.
{% endstep %}

{% step %}

### Next steps

What to do now that the cameras are in SureStream: activate the new licences in XProtect if they aren't yet, create SureStream views in the Smart Client, and set the Smart Client token timeout.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-ecae35dab0f8813891261e5052fd2417739df521%2Fmc-setup-10-next-steps.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Token timeout.** SureStream keeps streaming only while the Smart Client's XProtect login token is valid: **4 hours** by default. When the management server is down, the Smart Client can't renew it and logs out when it runs out. Set it to at least the time your support provider guarantees to restore the management server (your SLA). **Open the instructions** shows how; it is an XProtect setting.
{% endhint %}
{% endstep %}

{% step %}

### Review

A summary of the cameras added, their streaming modes, multicast addresses and mirroring, and each camera's login, mode and address by recording server. **Save as CSV...** saves the list (`SureStream cameras.csv`) for your records.

<figure><img src="https://2606467887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrW97Kdzpc3CRKor6jdzu%2Fuploads%2Fgit-blob-73d63b4edc0dc53640f1e9f7aa353467d2099e50%2Fmc-setup-11-review.png?alt=media" alt=""><figcaption></figcaption></figure>

Click **Finish**. The configuration is already saved. The [Camera Dashboard](https://docs.vega365.com/surestream/management-client/camera-dashboard.md) opens.
{% endstep %}
{% endstepper %}

Then [set up SureStream views](https://docs.vega365.com/surestream/smart-client/setting-up-views.md) in the Smart Client.
