Repository navigation
Home
ALPR Database Community runs natively on Windows 10 22H2 x64 and Windows 11 x64, or with Docker Compose on supported x86-64 Linux hosts. The same application, database schema, authentication and recognition models are shared.
- Step-by-step Windows installation
- Linux installation
- Blue Iris and Axis camera inputs
- Supported operating systems
- Docker on Windows or Linux → native Windows
- Backups and Linux-to-Windows migration
- Linux migration
- Latest stable release and installers
- Community roadmap
The searchable user guide and downloadable PDF are available under Help in ALPR. Use Settings → Release to identify your installed version and Settings → Software Updates for supported updates.
Detailed instructions are maintained in the versioned repository guides linked above. For an older installation, use the documentation at its release tag.
Use Discussions for setup questions and the bug report form for reproducible problems. Public reports must exclude passwords, API keys, real plates, camera images, private addresses and database contents. Report suspected vulnerabilities privately.
Release 0.1.61 fixes oversized image IDs in read-only Home Assistant displays. Unavailable image IDs now return HTTP 404 without a database overflow error. Camera scope, expiration, revocation and read-only permissions remain enforced. Use Settings > Software Updates; this patch adds no SQL migrations. See display setup and User Guide 3.29.
Release 0.1.60 fixes tracked database upgrades, Blue Iris camera setup, and Home Assistant display access. Use the normal updater; no manual SQL or intermediate release is required. Completed migrations are not replayed, and Blue Iris v2 direction observations remain preserved and visible. See the versioned update guide.
Blue Iris setup can refresh camera inventory, bind an ALPR alias to its recording short ID, and select an image owner when several reads match. Home Assistant uses expiring, revocable read-only display links with a camera scope and exact parent origin. Create links under Settings > Home Assistant; the old IP bypass is retired. See display setup and User Guide 3.28.
Community v0.1.59 adds Settings > Integrations > Camera Inputs. Choose Blue Iris or AXIS License Plate Verifier for each camera. Existing Blue Iris cameras appear automatically and continue using their existing alert actions.
Axis can send recognition, plate images and supported scene images through authenticated HTTP push, MQTT, or both. Configure the camera identity, external broker/topic, image storage, optional ROI, movement direction labels and immediate or finalized processing. Durable receipts support retry, transport deduplication and later corrections while preserving original observations and human review. Recognition remains independent of Blue Iris recording.
See camera setup and compatibility and User Guide 3.27. Physical Axis camera and firmware validation remains outstanding.
From Community v0.1.58, drag a header divider in Recognition Feed or Plate Database to resize its column. Widths save automatically and separately for each table in this browser. Double-click a divider to reset one column, or use Reset widths for the full layout. Keyboard users can focus a divider and use Left/Right arrows, with Shift for larger steps.
Narrow text uses an ellipsis and shows the full value on hover. Minimum widths keep controls usable; wider tables scroll horizontally. Actions starts as a compact ⋯ menu with full action names. Widen its column to restore the individual icons. See User Guide 3.26.
From Community v0.1.57, use Settings → General → Show State/Country column → Save Changes to enable the optional column in Recognition Feed and Plate Database. It is off by default. Operators and administrators can enter a value manually or select Previous entries. Reads of the same effective plate share the value; OCR does not populate it.
Administrator corrections start with batch correction and recurring misread aliases enabled. Review the scope and preview affected reads before applying a batch. See the current release guide and User Guide 3.29.
Detailed guides are versioned in the Community repository. For the exact installed version, use its release tag. Public reports must exclude credentials, private plate data and imagery.