Air-Gapped & Offline Operation

1# Air-Gapped Deployment Guide
2 
3# 1. Download offline package
4curl -<span class="text-yellow-300">L</span> https://releases.<span class="text-cyan-300">ztrace</span>.<span class="text-cyan-300">ai</span>/offline/v3.<span class="text-orange-400">2.<span class="text-cyan-300">0</span></span>/ztrace-offline.<span class="text-cyan-300">tar</span>.<span class="text-cyan-300">gz</span> \
5  -o ztrace-offline.<span class="text-cyan-300">tar</span>.<span class="text-cyan-300">gz</span>
6 
7# 2. Verify checksum
8sha256sum ztrace-offline.<span class="text-cyan-300">tar</span>.<span class="text-cyan-300">gz</span>
9# Expected: 8a7b9c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b
10 
11# 3. Transfer to air-gapped system (USB, secure transfer, etc.)
12 
13# 4. Extract on air-gapped system
14tar -xzf ztrace-offline.<span class="text-cyan-300">tar</span>.<span class="text-cyan-300">gz</span>
15cd ztrace-offline
16 
17# 5. Install dependencies
18./install-deps.<span class="text-cyan-300">sh</span>
19 
20# 6. Load AI models
21./load-models.<span class="text-cyan-300">sh</span> --model geo-v3 --model geo-v3-precision
22 
23# 7. Start local server
24./ztrace-server start \
25  --port <span class="text-orange-400">8080</span> \
26  --models ./models \
27  --data ./reference-data \
28  --license ./license.<span class="text-cyan-300">key</span>
29 
30# 8. Verify installation
31curl http://localhost:<span class="text-orange-400">8080</span>/health
32 
33# Response:
34# {
35#   "status": "healthy",
36#   "version": "3.2.0",
37#   "models_loaded": ["geo-v3", "geo-v3-precision"],
38#   "reference_data_version": "2024.12",
39#   "license_valid": true,
40#   "license_expires": "2025-12-31"
41# }
42 
43# 9. Configure SDK to use local server
44<span <span class=<span class="text-emerald-<span class="text-orange-400">400</span>">"text-purple-<span class="text-orange-400">400</span> font-medium"</span>>class</span>=<span class="text-emerald-<span class="text-orange-400">400</span>">"text-purple-<span class="text-orange-400">400</span> font-medium"</span>>export</span> ZTRACE_BASE_URL=http://localhost:<span class="text-orange-400">8080</span>
45<span <span class=<span class="text-emerald-<span class="text-orange-400">400</span>">"text-purple-<span class="text-orange-400">400</span> font-medium"</span>>class</span>=<span class="text-emerald-<span class="text-orange-400">400</span>">"text-purple-<span class="text-orange-400">400</span> font-medium"</span>>export</span> ZTRACE_API_KEY=local-key
46 
47# 10. Run analysis locally
48ztrace analyze ./image.<span class="text-cyan-300">jpg</span> --output ./result.<span class="text-cyan-300">json</span>