Skip to content

Export Docker ALPR databases from Windows or Linux for native Windows - #58

Merged
prsmith777 merged 12 commits into
mainfrom
codex/windows-docker-migration
Oct 22, 2026
Merged

prsmith777 merged 12 commits into
mainfrom
codex/windows-docker-migration

Conversation

@prsmith777

@prsmith777 prsmith777 commented Oct 22, 2026 •

Copy link
Copy Markdown
Owner

Problem and behavior

Users moving an existing Docker ALPR installation to native Windows could back up the new, empty native database instead of the old Docker database. Setup now offers a Docker exporter before installation, with explicit application/database selection, source-schema recognition and a visible plate-read count.

The exporter supports Docker Desktop on Windows and Docker on Linux. Linux users run ./alpr-community migrate export-docker, then copy the completed portable backup folder to Windows Setup. PostgreSQL 13/17 sources are exported logically using read-only PostgreSQL 17 clients. The selected application returns to its original running/stopped state. Original ports and volumes are retained.

Users pause Blue Iris ingestion and other writers through export, import and verification. Export validates the dump, settings, authentication and images, rechecks the source before sealing the backup, and rejects backup locations overlapping source storage. Import requires an empty target and does not merge histories. Instructions explain preserving records already collected by a new native installation.

Release validation also exposed a systemd user-bus startup permission race. Helper setup now retries that transient condition within its existing readiness bound; permanent denial retains the manual recovery path.

Windows/Linux installation and migration guides, User Guide 3.24, changelog and roadmap are updated for v0.1.56.

Validation

  • Final source CI: unit/platform tests, types, lint, build, sanitation, database fixtures, distro bootstrap checks and real unattended Linux helper startup pass.
  • Dependency-security gate passes for source 0b90303191e63da7644c15279d637f4135fe69b9.
  • Real Docker matrix passes for Original ALPR PostgreSQL 13/17 and Community PostgreSQL 17, named volumes and bind mounts, source attestation, row/image checks and source recovery.
  • Exact-tag stable Windows package: all CPU models, compiled installer lifecycle, 45 application/Settings routes (28 Settings pages), authentication, ingestion/images, direction persistence and a real Linux Docker backup restored into native Windows PostgreSQL pass.
  • Helper regression checks prove transient permission recovery, bounded permanent denial and propagation of unrelated filesystem failures.

Actual Docker Desktop GUI export on a Windows source computer remains a disclosed field-test limitation. No live ALPR database or ingestion configuration was modified by these tests.

@prsmith777 prsmith777 changed the title Export original Docker databases for native Windows migration Export Docker ALPR databases from Windows or Linux for native Windows Oct 22, 2026
@prsmith777
prsmith777 marked this pull request as ready for review October 22, 2026 01:08
@prsmith777
prsmith777 merged commit bed4dfe into main Oct 22, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant