Deployment

This section documents the full deployment pipeline for GeoAssistant, covering every service, tool, and concept involved in taking the platform from local development to production.

The goal of this documentation is not just to record what was done, but why — so that next time you return to this, you understand the reasoning behind every decision and can adapt it confidently.

• Core Concepts
  • Environment Variables
  • SSH Keys
  • Docker
  • DNS and Subdomains
  • JWT and Auth0
  • CORS
• Local Development Environment
  • Architecture
  • Hosts File
  • Caddyfile
  • Environment Variables
• Docker
  • Why Docker
  • Prerequisites
  • Generating a GitHub PAT
  • Loading the Token into Your Terminal
  • Dockerfile
  • Building the Image
  • Testing Locally
  • Pushing to Docker Hub
  • Clearing Build Cache
  • Updating Dependencies
• Hosting Services
  • Railway (API)
  • Vercel (SaaS App)
  • Netlify (Marketing + Docs)
  • Cloudflare (DNS)
• Authentication (Auth0)
  • Why Backend-Driven Auth
  • Auth0 Application Settings
  • API Implementation
  • Token Verification
  • Cookie Strategy
  • Testing the Auth Flow
• Frontend Configuration
  • Environment Variables in Vite
  • Marketing Site
  • SaaS App
  • Deployment Flow