Skip to content

Troubleshooting

prsmith777 edited this page Oct 22, 2026 · 6 revisions

Troubleshooting and FAQs

Start with Settings → Release and record the installed version and source revision. Keep exact error text and support logs privately; sanitize anything posted publicly.

Which Windows installer file do I need?

Choose Windows-x64-Setup.exe under Assets in the latest stable release. The source-code archive and Windows Update.zip are not the graphical Setup. See download and install for the four Setup choices.

Do I need to uninstall or replace the API key for an update?

No. Normal updates preserve the password, ingestion API key, data and settings. Use Settings → Software Updates, complete the listed checks and select Accept update. Older native Windows installations without the updater service need the latest graphical Setup once, using its existing-installation update option. See Windows updates.

Do Linux users still need to install the update helper manually?

Fresh installations and activated migration targets from v0.1.53 set it up automatically on systemd Linux hosts. Existing matching helpers are kept. For an older installation without a helper or a setup warning, run ./alpr-community agent install as the normal installation owner; it also enables startup after reboot and verifies readiness. It may request sudo permission once. Hosts without systemd can keep the terminal updater or use their existing service supervisor. See Linux browser update recovery.

Why does localhost work but another computer cannot connect?

localhost refers to the computer running the browser. Another device needs the ALPR computer's LAN address, application port and enabled local-network access. Follow Windows network access; keep the database port local.

How do I change the Windows PostgreSQL port later?

From v0.1.55, use Settings → General → Windows connection ports → Local PostgreSQL port. Select an unused port different from the application port, then choose Change PostgreSQL port and restart. Finish pending software updates first. Browser and Blue Iris URLs stay the same; PostgreSQL stays local. A conflict leaves ALPR running, and a failed or interrupted restart restores the previous database configuration. See Windows port guidance.

Why do Settings look different inside a VM?

The shared layout adapts to browser width and zoom. A narrow view uses a horizontally scrolling Settings navigation bar. Maximize the browser or adjust zoom to reveal the wider sidebar layout.

What if Setup fails or still shows the old release?

Verify Settings → Release on the target computer after Setup completes. Preserve the installed data, recovery folders and indicated support log. Follow interrupted-update recovery or row-count validation guidance. Keep antivirus enabled and retain the exact filename and threat name if a file was blocked.

Why is ReID not producing useful results?

ReID needs a usable whole-vehicle image. Save the camera's direction profile, then configure and save the recorded LPR or overview source and its timing for each direction. Use the frame diagnostics. Plate-only, clipped, ambiguous or monochrome frames may be unsuitable. See vehicle identity. Similarity is a review aid, not identity proof.

Why did my migration backup contain no old records?

ALPR Migration Backup exports native Windows Community. For an original Docker installation use v0.1.56+ Setup's Back up original Docker ALPR… button or the separate ALPR Docker Migration Backup shortcut. Review the selected application/database and plate-read count before export. Docker on Linux uses ./alpr-community migrate export-docker from a prepared current checkout on the source host. Preserve any records already collected by native Community; the importer requires an empty target and cannot merge histories. See Docker-to-Windows migration.

Where can I ask for help?

Use Discussions for setup help and the bug form for reproducible failures. Include the version and sanitized steps. Keep credentials, real plates, imagery, private addresses and database contents out of public reports. Use private vulnerability reporting for security concerns.

Where do I enable State/Country?

In Community v0.1.57 or later, open Settings → General, enable Show State/Country column, and select Save Changes. Then edit the value from Recognition Feed or Plate Database. You can type a new value, select a previous entry, or leave the field blank to clear it. The value is shared by reads of the same effective plate. If the control is missing, check Settings → Release and update first.

How do I resize columns or find the Actions buttons?

From v0.1.58, drag the divider at the right of a column heading in Recognition Feed or Plate Database. Actions uses a compact ⋯ menu with full names when narrow; widen the column to show individual icons. Narrow text is shortened with an ellipsis and retains its full value on hover. Double-click a divider to reset its column, or choose Reset widths to restore the complete layout. Widths are stored per table in this browser; another browser or computer has its own layout.