Cirrus AI · Installation Guide

Car Tracker installation guide

The physical installation, cable connections, and initial camera configuration for the Car Tracker system — part of the Cirrus AI suite of products.

Version · 1.0.0 Audience · Field installers & technical support

Introduction

This new Car Tracker solution is part of the Cirrus AI suite of products. The camera plugs directly into the controller, and a vendor-agnostic Camera Agent handles connected cameras.

What you need before starting

Confirm you have the right hardware and the correct power configuration for your controller version before heading to the install site. The instructions below focus on Milesight cameras, which can cover all use cases.

Hardware requirements

  • Cirrus Car Tracker Camera
  • Controller — A1 v2.x controller
  • Ethernet cable — UTP cable for connecting camera to controller
  • Power supply (if needed, for A1 v2.1 non-PoE controllers only) — 12 Vdc power supply OR Cirrus logo with 12 Vdc output, plus a DC power cable

Power options by controller version

Supported

A1 v2.2

PoE (Power over Ethernet)

The LAN port has PoE support, so the ethernet cable carries both data and power for the camera connection. Single cable, no additional connections needed.

Extra power

A1 v2.1

Separate DC power

Camera ethernet connects to the controller, but an additional 12 Vdc power feed is required to power the camera. This feed can be drawn from the Cirrus logo or from a separate breaker.

Not supported

T1

Currently not supported

Currently not supported, but support is technically possible. We cannot integrate PoE into the T1 controller, so it would work like the non-PoE A1 controller (A1 v2.1).

Physical installation

Mount the camera, run the cable to the controller, and verify the link is live before moving on to software preparation.

Mount the camera

Mount the camera following the Cirrus assembly SOP for the sheet metal frame and Milesight's positioning guidelines for the camera model in use.

Camera model

Milesight AI Road Traffic Pro Bullet Plus — models TS4466-X4RPE and TS8266-X4PE. The positioning values below apply to these models specifically. Cable: 47-0094 Cable — PoE RJ45 32.8 ft for Car Tracker.

Recommended positioning (TS4466-X4RPE / TS8266-X4PE)

SettingHeightWidthLengthA1 · Horizontal tilt angleA2 · Vertical pitch angle
Recommended10–20 ft0 ft65.6 ft0°10°–20°
Diagrams of installation height, and installation width and length
Height (H), width (W) and length (L) measurements.
Diagrams of installation horizontal tilt angle and vertical pitch angle
Horizontal tilt angle (A1) and vertical pitch angle (A2).
  • Aim the camera as head-on to license plates as possible. The video feed should face oncoming or departing plates as squarely as possible — keep the horizontal tilt angle (A1) close to 0° and avoid side-on views, which reduce read accuracy.
  • Ensure the camera has a clear view of the traffic lane
  • Consider lighting conditions (direct sunlight, shadows, night lighting)

Position on the enclosure (Cirrus assembly SOP)

  1. Align the cameras with the designated mounting positions on the left or right sides of the main enclosure. Recommended installation height: ~10-20 ft.
    Cameras aligned with the designated mounting positions on the left and right sides of the main enclosure
  2. Secure and mount the cameras firmly onto the sides of the enclosure following the assembly steps below.
    Cameras mounted on both sides of the enclosure
  3. Connect the 47-0094 RJ45 PoE network cable from the controller to the side camera.
    47-0094 RJ45 PoE cable routed from the controller to the side camera, rear view
    47-0094 RJ45 PoE cable routing to both side cameras, rear view

Assemble the camera and junction box

  1. Fix a sticker on the position where the camera is intended to be installed.
    Location sticker, 5.9 in by 5.9 in, showing mounting base outline, location holes, and cable hole, with TOP marking
  2. Remove the tension disc on the rear cover of the junction box, cut an opening in the rubber plug, route the cables through the opening, then fasten the rear cover to the sticker.
    Fastening the junction box rear cover to the location sticker on the mounting surface
  3. Install the front cover at an angle near 90° to the rear cover. Pay attention to the two "Top" markings — the "Top" on the bullet must be aligned to the "Top" on the junction box.
    Junction box internals: tension disc, rubber plugs, network cable, and power cable connections
  4. Adjust the cable length, connect the cables to the corresponding interfaces, and fix the tension disc. Close the junction box and fix the screws last. Plug the small rubber plug into any hole on the rubber plug that is not in use.
    Fixing the setscrew; remember to fix the setscrew tightly
  5. Adjust the shooting direction and fix the setscrew.
    Adjusting the shooting direction: 360 degree pan, 90 degree tilt, 360 degree rotation

Minimum image requirements for license plate recognition

Milesight requires all field deployments to meet these image quality standards for reliable recognition:

  • Plate height: license plate characters should appear 32–45 px high in the captured image
  • Focus and clarity: the plate area must be in sharp focus with all characters legible — no motion blur, glare, reflections, or severe over-/underexposure
  • Alignment: plates should be horizontally aligned, with tilt within ±5°
  • Framing: the plate must remain within the recognition area — not cut off, blocked, or at the extreme edges of the frame
  • Environment: avoid excessive bright sky or headlight exposure; ensure the plate area is evenly illuminated day and night
Pole or corner mounts

For field installation on poles or corners, several optional accessories are available — see Milesight accessories.

Connect cables

For PoE controllers (A1 v2.2)

  1. Connect camera to controller LAN port using UTP ethernet cable
  2. The ethernet cable provides both data and power — no additional connections needed

For non-PoE controllers (A1 v2.1)

  1. Connect camera to controller LAN port using UTP ethernet cable
  2. Connect DC power cable from camera to one of:
    • Separate 12 Vdc power supply, OR
    • Cirrus logo 12 Vdc output
  3. Verify camera power LED illuminates

Verify physical connection

  • Camera power LED should be on
  • Network activity LEDs on camera and controller should show activity
  • If using separate power supply, verify it is functioning correctly

Controller preparation

Using Screenhub Control Selective Field Upgrade (SFU), install the Camera Agent and Local Web Server and upgrade the Screenhub Player. Then complete the camera's first-time activation and reboot.

ScreenHub Control, Selective Field Upgrade: Camera Agent Version list with Assign Controllers action
ScreenHub Control → Selective Field Upgrade → Camera Agent Version → Assign Controllers.

Install required software

  • Install Camera Agent
  • Install Local Web Server (lws) 1.6.1 or later — provides the /camera-console/ reverse proxy with Milesight auto-activation / auto-login, plus the lws-access command for temporary LAN enable/disable used in Initial camera configuration
  • Upgrade Screenhub Player to version 5.11 or later

There is no required install order between Camera Agent and Local Web Server.

Wait for installation

Wait until all components are properly installed by SFU. This can take up to one hour.

To save time, expert users can log into the controller with webSSH and execute:

bash
systemctl restart selective-update.service

Wait for this command to finish.

Complete first-time camera activation

Required for the first camera setup. Before rebooting, open the camera console through the Local Web Server and complete the camera's first-time activation:

  1. Enable temporary LAN access and open http://<controller-hostname>.local/camera-console/ — see Open the camera web interface via the controller for the exact commands.
  2. Let the console complete the camera's first-time activation dialog. A successful login here means the camera's admin credential has been set.
  3. A Third-Party VMS popup appears next — click Skip (leave VMS disabled).
Click Skip within ~20 seconds

The auto-login script stops watching for the login page about 20 seconds after it loads and doesn't know about the VMS popup. If Skip isn't clicked in that window, the camera may not log in automatically and you'll need to log in manually.

Reboot controller

After activation, wait 1–2 minutes, then perform a soft reboot of the controller. Don't reboot immediately — the wait avoids a race condition during setup.

To reboot, log in to the controller with webSSH and run:

bash
sudo reboot
What the reboot does

On the next boot, the Camera Agent starts fresh, uses the correct credentials, and applies the default configuration to the camera. Once that is done, you should only need to adjust zoom, camera angle, and the region of interest.

If you open the camera console before this reboot, settings like LPR may show as disabled. This doesn't mean anything needs to be configured by hand — Camera Agent simply hasn't connected and applied its configuration yet.

Initial camera configuration

After the controller preparation steps and reboot, the Camera Agent applies the default configuration and the controller automatically registers the connected camera to Screenhub. Open the camera web UI through the controller's local web server and fine-tune the view.

Open the camera web interface via the controller

The camera's web UI is reachable through the controller's local-web-server (lws), which proxies the camera console and handles login automatically. You do not need to know the camera password.

Prerequisite

The controller must be running Local Web Server (lws) 1.6.0 or later — earlier builds do not provide the /camera-console/ proxy with auto-activation / auto-login, or the lws-access command used below.

  1. Enable temporary LAN access on the controller. Log in to the controller with webSSH and run:
    bash
    sudo lws-access enable --duration 30min
    This opens lws on the controller's LAN interface and registers an auto-revert timer; it also auto-reverts on reboot.
  2. From any device on the same LAN, open http://<controller-hostname>.local/camera-console/. <controller-hostname> is the controller's hostname (typically the controller ID, e.g. c1234). The camera UI appears directly — lws completes the Milesight first-time activation dialog the very first time and auto-fills credentials on every subsequent visit.
  3. When you are done, revoke LAN access early (optional):
    bash
    sudo lws-access disable
    Otherwise it auto-reverts when the duration expires.
Note

LAN access is intentionally short-lived. The controller normally binds lws to localhost only and exposes it to operators through the ScreenHub Control reverse SSH tunnel. sudo lws-access enable is a field-service escape hatch.

Automatic configuration

After the post-activation reboot, the Camera Agent automatically configures the camera. It applies these values every time it connects — at service startup and on every reconnect — not just once during setup.

Manual changes to these fields get overwritten

If you change any field below by hand in the camera web UI, the change persists only until the next connect/reconnect cycle, when Camera Agent re-applies its own values.

License Plate Recognition

Traffic → LPR → General

FieldFactory resetCamera Agent sets
Enable LPRUncheckedChecked
Detection ModePlate PriorityVehicle Priority
Repeat Plate Checktime4000 ms1000 ms
Attributes Identification — Plate Color, Vehicle Type, Vehicle Color, Vehicle Brand, Detection Region, Direction, Country / RegionUncheckedAll checked

Image — Day / Night Switch

Media → Image → General → Day/Night Switch — forces Day mode so plate reads stay consistent instead of drifting with the camera's IR-cut auto-switching.

FieldFactory resetCamera Agent sets
Day/Night SwitchAutoDay

Event Push

Data Transmission → Post → Post Settings — points the camera's HTTP event push at Camera Agent's receiver so plate events reach the agent in real time.

FieldFactory resetCamera Agent sets
EnableUncheckedChecked
URLblankhttp://192.168.5.100:8080
Select EventsLPR + 6 othersLPR + 6 others (unchanged)

System Time

System → System Setting → Date&Time — moves the camera off its own NTP sync and onto the controller's clock and timezone so plate-event timestamps convert to UTC correctly.

FieldFactory resetCamera Agent sets
Time Zone(UTC-08:00) United States - Pacific(UTC-05:00) United States - Eastern
Synchronize ModeNTP serverManual
Timecamera's own clockcontroller's current local time
Daylight Saving TimeAutomaticAutomatic (unchanged)
Timezone limitation

Controller timezone support is currently limited to America/New_York. If the controller is set to any other timezone, Camera Agent leaves System Time untouched. The clock is synced at startup/reconnect only, not continuously.

Double-check that LPR was enabled

Verify the mode was actually set, and enable it manually if not:

  1. In the camera web interface, click the settings wheels icon in the left sidebar
  2. Go to Traffic → LPR
  3. Check the box next to Enable LPR if it isn't already checked
Milesight web interface: settings wheels, Traffic, LPR, with the Enable LPR checkbox circled
Settings wheels → Traffic → LPR — make sure the Enable LPR box is checked.

Manual adjustments

Use the camera's web interface to fine-tune settings:

  • Zoom level: Adjust for optimal plate visibility. Use the live view page to check zoom level and see vehicle and license plate detection in real-time. Select LPR from the stream dropdown to see the detection overlay. Use the controls on the right side to adjust zoom.
Live view with LPR detection overlay in the Milesight web interface
Live view with LPR detection overlay — stream dropdown set to LPR, zoom controls on the right.

Configure Region of Interest (ROI)

  1. In the camera web interface, navigate to Traffic → LPR
  2. On the General tab, check the Enable LPR checkbox
  3. In the Detection Region section, draw on the camera preview to select the area of interest. The selected region is shown as a blue box.
  4. In Detection Settings, under Attributes Identification, check the box next to All
ROI configuration in the Milesight web interface: Traffic, LPR, General, with the detection region drawn as a blue box
ROI configuration in the Milesight web interface — Traffic → LPR → General, with the detection region drawn as a blue box.
Milesight web interface: Detection Settings with the Attributes Identification All checkbox checked
Detection Settings → Attributes Identification — make sure the All box is checked.

ROI best practices

The ROI should be configured to:

  • Exclude parked cars from detection
  • Limit detection to a single lane
  • Limit detection to a specific distance from camera
  • A trigger line setting is usually not required

The image below shows an example of a poorly configured ROI — the blue region covers too wide an area, capturing unwanted detections (highlighted in red boxes) that should be excluded from the detection region:

Poorly configured ROI example: blue region too wide, unwanted detections highlighted in red boxes
Example of what to avoid when drawing the detection region.

Verify date & time settings

With a new installation, the time shown on the LPR page can be wrong even when the Date&Time settings look correct. You must explicitly save them once:

  1. In the camera web interface, navigate to System → System Setting → Date&Time
  2. Click Save — even if all the settings already look correct
Don't skip this

If you don't click Save, the time on the LPR page will be wrong.

Milesight web interface: System, System Setting, Date and Time tab with the Save button at the bottom
System → System Setting → Date&Time — click Save even if the settings look correct.
After ROI

Once ROI is configured, the camera is ready.

MicroSD card

Add a Micro SD card to the Milesight camera for local storage, then format and configure it through the Local Web Server and camera page.

Prerequisites

  • Micro SD card
  • Physical access to the camera
  • A computer (or a device) that's on the same subnet as the camera

Power off the camera

  1. Power off the camera completely by disconnecting the PoE network cable or the 12V DC power supply to avoid damaging the mainboard.

Open the weatherproof bottom cover

  1. Loosen the screw on the rain cover and slide it back or remove it.
  2. Locate the protective plate on the underside (bottom part) of the camera body.
  3. Use a star screwdriver to unscrew the screws holding the bottom panel cover. Keep these screws safe.
Camera underside with the protective plate removed, exposed chamber with the Micro SD card slot highlighted
Protective plate removed — exposed chamber with the Micro SD card slot (highlighted).

Insert the Micro SD card

  1. Locate the Micro SD card slot inside the exposed chamber (see picture below).
  2. Refer to the picture below for the orientation of the SD card.
  3. Slide the card into the slot and press down until you hear a clear "click", indicating it is locked into place.
Close-up of the Micro SD card slot showing the card orientation
Micro SD card orientation in the slot.

Reassemble the cover

  1. Put the rain cover back into its place and tighten the screw securely.
Camera reassembled with the rain cover back in place
Camera reassembled with the rain cover back in place.

Format and configure via Local Web Server and Camera page

  1. Connect the camera's power/PoE cable.
  2. Open Local Web Server, click on Camera Access button.
    ScreenHub Control controller list with Local Web Server button, and the Local Web Server Camera Access page with Open Camera Console button
    Local Web Server → Camera Access → Open Camera Console.
  3. Navigate to Settings → Storage → Storage Management.
    Milesight camera web UI, Storage Management tab showing the SD card with Remove and Format buttons
    Storage → Storage Management — the SD card appears with Remove and Format options.
  4. Select the newly installed SD card and click Format, select EXT4 and click Confirm to start formatting the SD card.
    SD Card Formatting dialog with EXT4 selected, and Confirm and Cancel buttons
    SD Card Formatting dialog — select EXT4 and click Confirm.

Troubleshooting physical installation

Common issues that show up during the physical install. Click any item to expand it.

Cirrus customer support

Can't resolve an issue with the steps below? Email Cirrus Customer Support at support@cirrusled.com.

Camera not powering on

For PoE installations (A1 v2.2)
  • Verify ethernet cable is securely connected at both ends
  • Try a different ethernet cable
  • Verify the controller's PoE port is functioning
For non-PoE installations (A1 v2.1)
  • Verify DC power cable connections
  • Check power supply output voltage (should be 12 Vdc)
  • If using Cirrus logo, verify its 12 Vdc output is enabled

No network activity

Camera and controller LEDs show no activity
  • Verify ethernet cable is securely connected at both ends
  • Check for damaged cable or connectors
  • Verify controller LAN port LEDs show activity

Camera not appearing in Screenhub Control

Camera connected, but Screenhub Control doesn't show it
  • Verify Camera Agent software is installed (see Controller Preparation)
  • Verify camera is powered and connected
  • Wait a few minutes for automatic detection
  • Try rebooting the controller

Camera web interface not accessible

Cannot reach the camera's web configuration pages
  • Confirm LAN access is currently enabled — sudo lws-access status should report LWS LAN access: ENABLED.
  • Confirm the camera was detected and registered (see Camera not appearing in Screenhub Control).
  • mDNS (*.local) requires the client device to be on the same LAN and multicast not to be filtered. If <controller-hostname>.local does not resolve, fall back to the controller's IP address — http://<controller-ip>/camera-console/ works identically.
  • If lws auto-login does not complete (e.g. after a Milesight firmware upgrade changes UI selectors), toggle sudo lws-access disable then sudo lws-access enable --duration 30min and retry.