Skip to content
getgeolens.com
GeoLens Docs

Self-hosted Provider Notes

GeoLens self-hosts via Docker Compose. Production deployments commonly migrate the database to a managed PostgreSQL service (RDS, Cloud SQL, DigitalOcean Managed Database), storage to S3-compatible object storage, and cache to a managed Redis-compatible service (ElastiCache, Memorystore). The admin’s job at provisioning time is to wire the corresponding env vars correctly and ensure security-group / firewall rules permit outbound HTTPS to the chosen provider’s endpoints.

Backups with managed providers

Section titled “Backups with managed providers”

Backups intersect with managed-provider deployments in two places. First, managed PostgreSQL providers offer their own snapshot facilities (RDS automated backups, Cloud SQL backups, DO Managed Database snapshots). These are the recommended primary recovery mechanism because they use provider storage-layer snapshots. Second, the GeoLens backup service is still useful for application-level dumps when you need cross-version portability, such as upgrading from PostgreSQL 15 to 16 with logical-format dumps where a physical snapshot is version-locked.

Combine both: provider snapshots for primary recovery, GeoLens backups uploaded to S3 for offsite and cross-version archival. See Backups & restore for the GeoLens-side configuration.

Provider-specific notes

Section titled “Provider-specific notes”

TLS termination is typically handled at the load balancer or CDN layer; pick what fits your deployment. Cloud providers offer multiple managed paths: AWS Application Load Balancer with ACM, GCP Cloud Load Balancing, DigitalOcean App Platform’s automatic Let’s Encrypt, or self-managed Caddy/Traefik on a VM.

For the full AWS / GCP / DigitalOcean walkthrough (managed-service setup, env var wiring, DNS configuration, and provider-specific gotchas), see Self-host on AWS, GCP, or DigitalOcean.

See also

Section titled “See also”