ef8b1e0bd9
Files changed: engine/.embcache.json engine/changelog.md engine/lint-report.md vault/.trash/2026-06-19.md vault/docs/hardware/environment.md vault/docs/hardware/ip-allocation.md vault/docs/matrix/archivist.md vault/docs/matrix/matrix_host.md vault/docs/matrix/mautrix_signal.md vault/docs/matrix/synapse.md vault/docs/matrix/synapse_retention_discovery.md vault/docs/navi/cc-rules.md vault/docs/navi/deployment.md vault/docs/navi/themes.md vault/docs/services/ots-setup.md vault/docs/services/services.md vault/docs/services/usenet.md vault/docs/software/authentik.md vault/docs/software/caddy.md vault/docs/software/central.md vault/docs/software/dns.md vault/docs/software/geo-tools.md vault/docs/software/navi.md vault/docs/software/recon.md vault/docs/software/searxng.md vault/glossary.md vault/notes/echo6-landing-page-data-export.md vault/notes/ia-download-queue.md vault/projects/advbbs-project.md vault/projects/argus.md vault/projects/deploy-livesync.md vault/projects/fleet-patch-audit.md vault/projects/fleet-platform-baseline.md vault/projects/matrix-synapse-deployment.md vault/projects/meshai-config-hot-apply.md vault/projects/meshai-region-routing-plan.md vault/projects/meshai.md vault/projects/meshcore-transport.md vault/projects/meshtastic-headscale-runbook.md vault/projects/mmud-project.md vault/projects/nominatim-v5-reimport.md vault/runbooks/add-peertube-channel.md vault/runbooks/authentik-access-groups.md vault/runbooks/authentik-create-invitation.md vault/runbooks/authentik-oidc-application.md vault/runbooks/authentik-upgrade.md vault/runbooks/central-deploy-cutover.md vault/runbooks/ct-runbook.md vault/runbooks/edge2-access-reference.md vault/runbooks/expose-service-contabo.md vault/runbooks/expose-service-edge2.md vault/runbooks/expose-service-home.md vault/runbooks/fleet-magicdns-resolved-migration.md vault/runbooks/headless-browser-page-verification.md vault/runbooks/headscale-oidc-boot-order.md vault/runbooks/headscale-onboard-node.md vault/runbooks/ia-cli-reference.md vault/runbooks/ia-download-mirror.md vault/runbooks/idahomesh-bridge-setup.md vault/runbooks/idahomesh-vpn-device-setup.md vault/runbooks/lxc-service-migration.md vault/runbooks/mailcow-create-mailbox.md vault/runbooks/meshai-prod-compose-override.md vault/runbooks/meshmonitor-password-reset.md vault/runbooks/meshtastic-sidecar-node.md vault/runbooks/meshtasticd-sim-nodes-runbook.md vault/runbooks/nordvpn-lxc.md vault/runbooks/peertube-remote-runner.md vault/runbooks/pg-backup.md vault/runbooks/pi-nas-omv-runbook.md vault/runbooks/pipeline-patterns.md vault/runbooks/proxmox-create-ubuntu-vm.md vault/runbooks/proxmox-onboard-node.md vault/runbooks/pymc-repeater-kiss-tnc-reenumeration.md vault/runbooks/recon-operations.md vault/runbooks/recon-service-integration.md vault/runbooks/syncthing-add-node.md vault/runbooks/toc-cortex-pve9.2-update.md vault/session-resume/SESSION-HANDOFF-meshai-test.md
69 lines
1.6 KiB
Markdown
69 lines
1.6 KiB
Markdown
---
|
|
title: Navi Deployment
|
|
type: reference
|
|
tags:
|
|
- recon
|
|
aliases: []
|
|
related:
|
|
- [[cc-rules]]
|
|
- [[navi]]
|
|
- [[recon-operations]]
|
|
- [[central-deploy-cutover]]
|
|
- [[themes]]
|
|
updated: 2026-07-13
|
|
---
|
|
# Navi Deployment
|
|
|
|
## Source Repository
|
|
|
|
**Location:** VM 1130 (`192.168.1.130`) at `/home/zvx/projects/repos/navi`
|
|
|
|
> **WARNING:** Never deploy from `/home/zvx/projects/navi-work` on cortex — that clone is stale.
|
|
|
|
## Build & Deploy
|
|
|
|
```bash
|
|
# SSH to VM 1130
|
|
ssh recon-vm
|
|
|
|
# Always backup first
|
|
cp -r /mnt/nav/frontend /mnt/nav/frontend.bak.$(date +%Y%m%d-%H%M%S)
|
|
|
|
# Build and deploy
|
|
cd /home/zvx/projects/repos/navi
|
|
npm run build && rsync -av --delete dist/ /mnt/nav/frontend/
|
|
```
|
|
|
|
## Infrastructure
|
|
|
|
- **Nginx** on VM 1130 serves `/mnt/nav/frontend/` on port 8440
|
|
- `index.html`: no-cache (always fresh)
|
|
- Hashed assets (`*.js`, `*.css`): cache forever
|
|
- **[[caddy]]** on CT 101 routes `navi.echo6.co` → VM 1130:8440
|
|
|
|
## Pre-Deploy Checklist
|
|
|
|
1. Merge feature branch to master before deploying
|
|
2. Check for unmerged upstream commits:
|
|
```bash
|
|
git log your-branch..master --oneline
|
|
```
|
|
3. Create backup (see above)
|
|
|
|
## Post-Deploy Smoke Tests
|
|
|
|
Run after **every** deploy:
|
|
|
|
- [ ] Route between two addresses — polyline renders
|
|
- [ ] Click city label — boundary outline appears
|
|
- [ ] Theme switching works (dark, light, clean, cyberpunk)
|
|
- [ ] Toggle overlays (hillshade, contours, public lands)
|
|
- [ ] Console: no `bt is not defined` or `f is not defined` errors
|
|
|
|
## Rollback
|
|
|
|
```bash
|
|
# If deploy fails, restore backup
|
|
rm -rf /mnt/nav/frontend
|
|
mv /mnt/nav/frontend.bak.YYYYMMDD-HHMMSS /mnt/nav/frontend
|
|
```
|