Skip to content

Add cross-platform deployment support and live information layers - #10

Merged
bd4rex merged 32 commits into
mainfrom
codex/linux-server-deployment
Aug 31, 2026
Merged

bd4rex merged 32 commits into
mainfrom
codex/linux-server-deployment

Conversation

@bd4rex

@bd4rex bd4rex commented Aug 16, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • add the native Linux deployment entry point, systemd application/backup units, and production-tested Ubuntu runtime fixes
  • keep Windows and Linux on the same PowerShell lifecycle/data pipeline while preserving stable root .cmd launchers and the unified terrasys.sh dispatcher
  • organize deployment documentation under docs/deployment with maintained Windows workstation and Linux server guides, plus a project-structure and data-ownership guide
  • add the keyless live information-layer API and management console

Deployment validation

  • deployed on Ubuntu 24.04.4 LTS with kernel 6.8.0-137-generic
  • expanded the 1 TiB system disk to a 1006 GiB ext4 root filesystem
  • started 8 healthy application containers and enabled the TerraSys service plus daily backup timer
  • restored the existing personal GIS database and installed five regional map packs
  • built and validated Carto rendering, Nominatim search, Valhalla routing, Kiwix content, elevation, weather, nautical, and global overview resources
  • verified the web listener is restricted to the configured VPN address on port 8080

Documentation and structure

  • shared platform-selection and equivalent-command index
  • complete Windows Docker Desktop, Task Scheduler, backup, upgrade, and recovery procedure
  • complete Linux disk, package, direct-download, systemd, backup, and verification procedure
  • explicit boundaries for tracked source, private state, generated products, and recovery material
  • recursive bilingual-pair and local-link checks for organized documentation subdirectories

Tests

  • Windows static profile: 50 PowerShell files, 5 shell entry points cataloged, 28 bilingual pairs, 303 local Markdown links, and 7 live-layer unit tests passed
  • Ubuntu production full profile: static contracts, health, API lifecycle, UI, resource console, information-layer console, world map, and performance tests passed in 152.5 seconds
  • system-ready timing: 852 ms, 49.9% faster than the recorded baseline
  • external VPN probes returned HTTP 200 for web/API/wiki/manifests and HTTP 206 for PMTiles range requests

@bd4rex bd4rex changed the title Add Linux deployment support and live information layers Add cross-platform deployment support and live information layers Aug 31, 2026
@bd4rex
bd4rex marked this pull request as ready for review August 31, 2026 15:39
@bd4rex
bd4rex merged commit 1e34584 into main Aug 31, 2026
2 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