Skip to main content

Stream Offline Installation

Follow these steps 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 the compressed archive:

    docker load < alpr-stream.tar.xz

Generate the seed.conf file​

  1. If you are on version 1.48 or below, ensure you have or request a stream-init.zip from us.

  2. If you are on version 1.48 or below, unzip stream-init.zip. It will create a 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. Send us the generated HW Fingerprint file. The file location is /path/to/stream/seed.conf. For the example extract destination above, 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.