Self-Hosting

Everything you need to deploy, configure, and operate your own TimeTiles instance.

System requirements, Docker, firewall, and DNS setup.

Docker Compose, all-in-one container, or automated bootstrap.

Environment variables, geocoding, feature flags, and content management.

Backups, updates, monitoring, and troubleshooting.

Themes, branding, layout templates, and custom CSS.

Trust levels, quotas, rate limiting, and HTTP caching.

Architecture

TimeTiles runs as a set of Docker containers:

Service	Role
web	Next.js application with Payload CMS
postgres	PostgreSQL 17 + PostGIS 3.5
worker-ingest	Processes file imports and geocoding
worker-default	Runs scheduled imports and webhooks
worker-maintenance	Periodic cleanup and system jobs
nginx	Reverse proxy with SSL/TLS termination
certbot	Automatic Let’s Encrypt certificate renewal