Skip to main content

Plate Recognizer Snapshot

We provide a Docker image with our ALPR technology. It can be used on-premises without an internet connection. It lets you read license plates from a vehicle picture. To use it, you will need to get a SDK license. An internet connection is needed during installation.

Install#

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

2) Install Snapshot, you have two options:

  1. Using the Plate Recognizer Installer for Windows, Linux and Mac. Easy if not conversant with Docker.
  2. Using the Manual steps. Quick if well conversant with Docker. For Jetson devices, see our Jetson FAQ.
tip

We generally recommend using the Plate Recognizer Installer to do the install.

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

Upgrade#

  1. Stop the running containers using the image. Run docker ps -q --filter ancestor=platerecognizer/alpr to get the container id. And then docker stop CONTAINER_ID to stop it.
  2. Update the image: docker pull platerecognizer/alpr.
  3. Run the container (see last step of Installation).

Uninstall#

Each license can only be used on a single machine. If you need to move your installation to a new machine, you must first uninstall it from the initial machine.

  1. On the machine running ALPR, verify that the container is running with the command.

    • docker ps

  2. Run the command to uninstall license. Replace the HOST-IP with the IP of the machine running the container, localhost in case of the same machine.

    • curl http://HOST-IP:8080/uninstall/

    or directly in the browser:

    • http://HOST-IP:8080/uninstall/

  3. Stop the running containers using the image. To identify the container use command:

    • docker ps -q --filter ancestor=platerecognizer/alpr

    to stop and remove use the command:

    • docker stop CONTAINER_ID
    • docker rm CONTAINER_ID.
danger

For the command 2.) above, make sure to change YYYYY to your Plate Recognizer Token. Get your Token. If you are not using the image platerecognizer/alpr, update the command above with the correct image.

System Requirements#

For best performance, we recommend running the container from a Linux machine. With a recent processor (7-8 gen Intel CPU with 4 cores), inference should take 50-100ms. Minimum requirements are:

  • Use an OS that supports Docker. See the installation guide for how to install on Windows, Mac or Linux.
    • If your system does not meet the requirements to run Docker Desktop, you can install Docker Toolbox.
  • Intel CPU 3rd gen or higher (must support AVX instructions). We also support the Raspberry Pi3 (inference speed of 1 second).
  • At least 500MB of free RAM.
  • If you are using VMware, you should disable EVC.

You can also use a recent Nvidia GPU with a minimum compute capability of 6.1 and can support minumum Cuda version of 9.0 (Tested with drivers version 450). Follow the above instruction on Docker installation and Nvidia-docker

tip

If you are behind a firewall you might also need to whitelist these IP addresses