Manual Installation Steps
If for some reason, you prefer not to use Plate Recognizer Installer, you can go through the steps below to manually install Stream with Docker.
danger
For the commands below, make sure to change XXXXX with your License Key and YYYYY with your Plate Recognizer Token. Get your token and license key.
#
List of Docker ImagesThere are Docker images for various architectures and engine customizations for some countries. The image structure is
platerecognizer/<architecture>:<country>-<version>
<architecture>
- x86
alpr
- x86 with Nvidia GPU
alpr-gpu
- Raspberry Pi
alpr-raspberry-pi
- Apple Silicon M1/M1 Pro use
alpr-raspberry-pi
- Nvidia Jetson (with GPU)
alpr-jetson
. We support 2 Jetpack versions:r35.1.0
andr32.6.1
(default). - ZCU
alpr-zcu104
- x86
<country>
: leave blank for global engine,thailand
,germany
,korea
,japan
,egypt
.<version>
: leave blank for latest.- To see the list of tags, select an image from Docker Hub and then click "Tags".
Here are a couple of examples:
- Image for x86 with a specific version:
platerecognizer/alpr:21-09-13
- Image for x86 customized for
thailand
:platerecognizer/alpr:thailand
- Image for Jetson:
platerecognizer/alpr-jetson
#
Installation#
Installation on an Intel CPUAbbreviated installation steps below. For a detailed, step-by-step guide, see the Install Docker and SDK on Windows and the associated FAQ for help.
- Sign up and log in.
- Subscribe to a SDK plan.
- Install Docker on your local machine. See requirements.
- Get our SDK image. In a terminal run
docker pull platerecognizer/alpr
- Install and run the container:
docker run --restart="unless-stopped" -t -p 8080:8080 -v license:/license \ -e TOKEN=4805bee*********** -e LICENSE_KEY=AX******** \ platerecognizer/alpr
tip
If you use the engine for Thai vehicles, replace platerecognizer/alpr
by platerecognizer/alpr:thailand
.
#
Installation on a Raspberry PiFollow the steps 1) to 3) of the standard installation instructions.
- Get our SDK image. In a terminal run
docker pull platerecognizer/alpr-raspberry-pi
- Run the container. Initialization can take up to 10-20 seconds.
Use the command 5) but with image
platerecognizer/alpr-raspberry-pi
#
Installation for Desktop GPU (Nvidia Only)If you have an Nvidia Jetson, follow these instructions. Make sure you have installed the right Nvidia drivers and have Nvidia-docker installed. Tested with drivers version 450. Follow the steps 1) to 3) of the standard installation instructions.
- Get our SDK image. In a terminal run
docker pull platerecognizer/alpr-gpu
- Run the container.
Option 1 (new version of nvidia-docker), notice the --gpus all:
docker run --gpus all --restart="unless-stopped" -t -p 8080:8080 -v license:/license -e TOKEN=YYYYY -e LICENSE_KEY=XXXXX platerecognizer/alpr-gpu
Option 2 (Deprecated nvidia-docker2 version):
docker run --runtime nvidia --restart="unless-stopped" -t -p 8080:8080 -v license:/license -e TOKEN=YYYYY -e LICENSE_KEY=XXXXX platerecognizer/alpr-gpu
#
Installation for Nvidia JetsonConfigure the Nvidia Jetson according to the official Jetson Nano Developer Kit Guide. Our image has been tested on Jetpack 4.6. For more Jetson information, check our FAQ.
Follow the steps 1) to 3) of the standard installation instructions.
- Get our SDK image. In a terminal run
docker pull platerecognizer/alpr-jetson
- Run the container. The initial prediction can take up to 2-3 minutes. After the first prediction, inference speed is around 300ms.
docker run --runtime nvidia --restart="unless-stopped" -t -p 8080:8080 -v license:/license \ -e PROCESS_GPU_FRACTION=0.25 -e TOKEN=YYYYY -e LICENSE_KEY=XXXXX \ platerecognizer/alpr-jetson
tip
- Having problems running the container? Check our Jetson FAQ.
- Memory consumption may be high by default. You can control the amount of memory used with
PROCESS_GPU_FRACTION
.
#
Installation for KubernetesRefer to the documentation with Helm charts here
#
Calling the APIThe container exposes a REST interface. To verify that the installation was successful, run those commands in a new terminal.
- Windows
- Linux
:: Get a picturecurl -o car.jpg https://app.platerecognizer.com/static/demo.jpg:: And read the license platecurl -F "[email protected]" http://localhost:8080/v1/plate-reader/
# Get a picturecurl -o /tmp/car.jpg https://app.platerecognizer.com/static/demo.jpg# And read the license platecurl -F 'upload=@/tmp/car.jpg' http://localhost:8080/v1/plate-reader/
View the output format documentation. Do you need to process multiple files? Check bulk processing.