Stream Offline Installation

Here are the step to run Stream on a machine without internet or access to Docker Hub

Install or Upgrade

This assumes you already have Docker installed on a machine without internet.

1. Download the Stream Docker image from Docker Hub on a machine with internet.

   docker pull platerecognizer/alpr-stream

2. Save the image as a tar archive

   docker save platerecognizer/alpr-stream > alpr-stream.tar

   Optionally, Compress the archive to reduce the size

   xz -9 alpr-stream.tar

3. Copy the archive to the machine without internet. For example, use a flash drive that you can physically move to the second machine.

4. Load the Stream image from the tar archive that was copied.

   docker load < alpr-stream.tar

   Or load compressed

   docker load < alpr-stream.tar.xz

Generate the seed.conf file

1. If you're on version 1.48 or below. Ensure you have or request a stream-init.zip from us

2. If you're on version 1.48 or below. Unzip stream-init.zip. It will create stream folder with a .stream folder inside it. Example:

   unzip /path/to/stream-init.zip -d /tmp/
   ls -l /tmp/stream/.stream # you now have /tmp/stream/.stream/license.lic

3. Run Stream with a new folder bind mounted to the /user-data folder in the container and with the parameter -e CREATE_SEED=1. This will generate a HW Fingerprint file named seed.conf. Example Run Command:

   docker run --rm -t --name stream -v /tmp/stream:/user-data/ \
     -e CREATE_SEED=1 -e LICENSE_KEY=YOUR_LICENSE_KEY -e TOKEN=YOUR_API_TOKEN \
     platerecognizer/alpr-stream

4. Kindly send us the generated HW Fingerprint file. The file location is /path/to/stream/seed.conf. For my example extract destination, the file location would be: /tmp/stream/seed.conf.

Copy device.conf to the Offline Machine

1. We will upgrade the HW Fingerprint to allow Stream to be used on your device that is unconnected. We will share back a file device.conf after the upgrade.

2. Copy the updated HW Fingerprint file to the Stream directory. For example, on Linux, mv device.conf /tmp/stream/.stream. You can manually copy and paste on Windows. You can now run Stream without an internet connection.

What happens if the license is modified?

If the license is changed after we send you the device.conf, we would have to reprocess the same seed.conf file with the updated license. Then you would have to copy a new device.conf to the offline machine.