Files
jobtrackingapp/docs/development/WINDOWS_DOCKER.md
T

3.3 KiB

Rebuild and run locally on Windows

Start Docker Desktop in Linux containers mode, then run PowerShell:

powershell -NoProfile -ExecutionPolicy Bypass -File "C:\Users\Connor\.codex\worktrees\direct-roadmap-integration\Job tracker\scripts\rebuild-windows-docker.ps1"

Open http://localhost:3000 after the script finishes. It rebuilds backend/frontend from that checkout, reports its branch/commit and starts a separate jobjakt-windows-local project. It neither pulls Git changes nor selects main; run it again after development checkpoints are integrated into this checkout. Working-copy changes are included in Docker's ordinary build context. First build needs internet for existing base images and locked dependencies.

Login is local-admin@example.test. The generated password is the JT_LOCAL_ADMIN_PASSWORD value in .env.windows-local at the checkout root; open that private file locally to read it. The file is ignored by Git. Keep it and use the same checkout for subsequent rebuilds: changing database credentials after volumes exist prevents connection. The separate local database starts empty; existing production accounts/data are not imported.

Useful options:

# Use another local port if3000 is occupied.
.\scripts\rebuild-windows-docker.ps1 -Port 3001

# Validate configuration without building or starting containers.
.\scripts\rebuild-windows-docker.ps1 -ValidateOnly

# Rebuild without Docker layer cache when needed.
.\scripts\rebuild-windows-docker.ps1 -NoCache

# Stop this local project, retaining its database/files and credentials.
docker --context desktop-linux compose --project-name jobjakt-windows-local --env-file .env.windows-local -f dev/windows-local.compose.yml stop

The last commands run from the same checkout root. -DockerContext default is available if that is your local Linux Docker context. The start path rejects remote Docker endpoints and non-Linux engines. The script never deletes volumes or pushes images. Database/files/tombstones have separate named volumes owned by this project; only frontend port3000 is exposed, on127.0.0.1. The API/database are internal.

This stack intentionally has no AI sidecar/Ollama, mail delivery or background provider/model workers. Existing manual application/Career/CV/PDF workflows remain available; generative and sidecar-dependent import functions need their separately approved test stack. AI activation remains a separate owner decision, including model identity and local-only routing. No production Compose/environment is loaded.

Verification

18November2026: PowerShell parser and rendered Compose contract tests 2/2 PASSED, zero skips; -ValidateOnly twice PASSED, preserving the credential file. Checks cover exact build contexts, three-service allowlist, loopback port, internal API/database, persistent project-owned volumes, same-origin routing, authentication and disabled external/background processing. python scripts/test-windows-docker.py executes no build/container commands.

Docker build/start NOT RUN: local Docker Desktop Linux engine pipe was absent when inspected. Start Docker Desktop before running the script. Source/static checks do not establish container startup, image builds, Node20 compatibility, database migration parity, PDF fidelity or full release qualification.