project-nomad/install
Ken Eucker f46abd17e2 fix(install): explain that the bundle builder can't run under Git Bash
`./install/build_offline_bundle_docker.sh` on Windows died with "No Docker
socket at /var/run/docker.sock. Set NOMAD_DOCKER_SOCKET if yours lives
elsewhere." — advice that cannot be followed, because there is no socket path
to point at. Docker Desktop is reached over a named pipe.

The docs claimed "Linux, macOS and Windows build machines all produce the same
bundle", which is not true of Windows' native shells and is what sent the user
down this path.

Relaxing the `-S` guard would not fix it. The build starts further containers
whose bind mounts are resolved by the host daemon, and MSYS rewrites the
Unix-looking paths in every -v argument — so the socket mount, the repo mount
and the output mount each need different treatment. Dropping the check just
moves the failure somewhere less obvious.

So: detect MSYS/MinGW/Cygwin and fail immediately with the actual remedy (build
from WSL2, Linux or macOS), and correct the Windows claim in the docs. Real
Git Bash support would mean reworking mount-path construction and is a separate
piece of work.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-15 22:04:21 -07:00
..
calibre-empty-library feat(supply-depot): per-app onboarding docs, install fixes, and in-app Docs links 2026-06-23 04:46:47 +00:00
sidecar-disk-collector chore: standardize brand name to Project NOMAD, retire backronym 2026-08-04 03:37:32 +00:00
sidecar-updater fix(updater): prune superseded images after update to reclaim disk (#1101) 2026-08-04 03:37:36 +00:00
tests feat(install): add offline artifact installation mode 2026-08-14 14:17:03 -07:00
build_offline_bundle.sh feat(install): --use-local-images so a bundle can carry an unreleased build 2026-08-15 20:19:27 -07:00
build_offline_bundle_docker.sh fix(install): explain that the bundle builder can't run under Git Bash 2026-08-15 22:04:21 -07:00
capture_installed_images.sh feat(install): add offline artifact installation mode 2026-08-14 14:17:03 -07:00
collect_disk_info.sh feat: disk info collection 2025-12-07 19:13:43 -08:00
entrypoint.sh fix: lazy-connect + retry for ioredis to avoid blocked startup 2026-06-23 17:40:10 +00:00
install_nomad.sh feat(install): add offline artifact installation mode 2026-08-14 14:17:03 -07:00
management_compose.yaml docs(install): make storage-relocation guidance accurate and consistent (#1103) 2026-08-04 03:37:37 +00:00
migrate-disk-collector.md chore: standardize brand name to Project NOMAD, retire backronym 2026-08-04 03:37:32 +00:00
migrate-disk-collector.sh chore: standardize brand name to Project NOMAD, retire backronym 2026-08-04 03:37:32 +00:00
run_updater_fixes.sh chore: standardize brand name to Project NOMAD, retire backronym 2026-08-04 03:37:32 +00:00
start_nomad.sh chore: standardize brand name to Project NOMAD, retire backronym 2026-08-04 03:37:32 +00:00
stop_nomad.sh chore: standardize brand name to Project NOMAD, retire backronym 2026-08-04 03:37:32 +00:00
uninstall_nomad.sh fix(install): define missing header_red + colors in uninstall/update scripts (#1098) 2026-08-04 03:37:35 +00:00
update_nomad.sh docs: document Ubuntu 26.04 LTS as the recommended OS in the in-app docs (#1159) 2026-08-04 03:39:59 +00:00
verify_offline_bundle.sh feat(install): add offline artifact installation mode 2026-08-14 14:17:03 -07:00
wikipedia_en_100_mini_2025-06.zim fix(ZIM): host initial zim download in GH repo 2025-09-02 22:44:01 -07:00
wikipedia_en_100_mini_2026-01.zim build: add latest initial zim file 2026-03-24 02:08:18 +00:00