Stream On Premise

Stream is a highly accurate ALPR software that efficiently processes live camera or video feeds in real time. It can run on-premise, supporting a wide range of architectures, including Windows, Linux, macOS, Jetson devices, and Raspberry Pi.

note

1. A Stream license is tied to the device specifications. If you change some hardware it will stop working.

• We recommend that you uninstall Stream before you make any hardware changes.
• In situations where you changed the hardware, please Contact Us to let us know. Please include the Stream License and also a screenshot of the error message.

2. Making any edits to the config.ini would require you to restart Stream

Install

1) Install Docker on your machine. See the system requirements.

• Docker Windows install instructions. Watch 5 minute video on installation steps. Are you stuck? Check our FAQ for help.
• Docker Linux install instructions

2) Install Stream, there are 2 options:

1. Using the PR Installer (Intel x86 only). This is the preferred path if you are not as conversant with Docker.
2. Using the Manual steps. This is the preferred path if you are conversant with Docker.

• Use this Manual steps if your device is Raspberry Pi or a NVidia Jetson.

tip

We recommend using the Plate Recognizer Installer.

We have created a special version of our Snapshot SDK for Thailand, which understands Thai characters, and for Germany and Austria, which identifies umlauts and space gaps, as well as for specific hardware devices. These require Manual Installation Steps. Please see our list of Docker Images.

tip

You can use the Automatic Stream installation Script. This script dynamically verifies the presence of Docker and installs it if it is not already available. Subsequently, the script orchestrates the configuration and launch of Stream.

Start Stream

Upgrade

To update to a newer version of Stream, just run the following commands:

docker container stop stream
docker pull platerecognizer/alpr-stream:latest

If the latest image is pulled successfully, proceed to delete the current container (which is running the older image):

docker container rm stream

Now you have to execute the same command you used to run Stream the first time, adding the latest image tag, format:

docker run --restart="unless-stopped" --name stream \
-v path/to/your/stream/working/directory:/user-data \
-e LICENSE_KEY=YOUR_LICENSE_KEY_HERE -e TOKEN=YOUR_TOKEN_HERE \
platerecognizer/alpr-stream

warning

Ensure to provide the correct path/to/your/stream/working/directory, it has to be the same one you have been using so far.

For more information about the run command, use our Stream docker command selector.

Once you execute the run command, your Stream container based on the latest image should start using the same configuration you set to the "older" version.

tip

You can also use this procedure to pick a specific version instead of the latest by using git tags. For example, platerecognizer/alpr-stream:jetson-1.28.1-r32.6.1.

Uninstall

To uninstall Stream, just remove the image with the following Docker command:

docker image rm platerecognizer/alpr-stream

note

The license is still tied to the original device. Please contact us to remove the fingerprint after you uninstall Stream.