God's Eye View Live Satellite and World Tracker
God's Eye View is an open-source 3D globe for live public data: aircraft, satellites, earthquakes, cyclones, rocket launches, weather and public traffic cameras. This template builds release v0.3.0 from source behind a generated login, with a feed cache on a volume and no API key required.
What you get
- God's Eye View v0.3.0 built from a pinned commit, serving its production bundle and data routes
- A Caddy gateway as the only public endpoint, with a password login (user admin, generated GEV_UI_PASSWORD)
- A volume at /app/.gev-cache for cached feeds and the TomTom daily budget
- Flights, satellites, earthquakes, cameras and launches working without any keys
- Optional keys set as Railway variables for Cesium ion, AISStream, NASA FIRMS, TomTom, Mapillary, OpenSky, Google Maps, OpenAI or Gemini
Good for
- Exploring live air, sea and space traffic for OSINT, geospatial teaching, demos and video work
- A shared, password-protected situational view for a small team
- Following a live aircraft in cockpit view or tracking the ISS in real time
- A starting point for your own layers by forking the app
Services in this template
- gods-eye-view · from
baranberkay96/gods-eye-view-railway - gateway · from
baranberkay96/gods-eye-view-railway
Questions people ask
How do I log in?
Copy GEV_UI_PASSWORD from the gateway service variables and sign in at your domain as admin (GEV_UI_USERNAME). Then pick a first-run mission such as Live Contacts.
How do I add API keys?
Set them on the gods-eye-view service and deploy; the in-app POWER UP panel cannot save keys on a hosted server. CESIUM_ION_TOKEN, GOOGLE_MAPS_API_KEY and MAPILLARY_CLIENT_TOKEN are built into the page and visible to anyone who can open it, so restrict them by referrer or URL. Set budgets at OpenAI and Google, because the app's throttles are not billing caps.
Are there data licence limits?
Yes. The code is MIT, but every feed keeps its own terms. OpenSky's licence is non-commercial, the bundled submarine-cable map (CC BY-NC-SA) and Nepal flood scene (CC BY-NC) are non-commercial, and DelDOT live video needs DelDOT's agreement beyond personal viewing (CCTV_DELDOT_ENABLED=0 turns it off). Commercial operators should read upstream's DATA_SOURCES.md and get advice.
Can I use it for navigation or emergencies?
No. It shows public and third-party data that can be delayed, incomplete or wrong, and should not be used for navigation, emergency response or other safety-critical decisions.
How do I use a custom domain or upgrade?
Add the domain to the gateway service and to GEV_ALLOWED_HOSTS on gods-eye-view. To upgrade, set GEV_VERSION and GEV_COMMIT together and deploy; the build stops if they do not match. Keep gods-eye-view at one replica.
Full template README
Deploy and Host God's Eye View with Railway
God's Eye View is an open-source 3D globe for live public data: aircraft, satellites, earthquakes, cyclones, rocket launches, weather and public traffic cameras, with optional ships, wildfires and voice control. This community template builds release v0.3.0 from source, puts it behind a generated login and keeps its feed cache on a volume. No API key is required.
About Hosting God's Eye View
God's Eye View is a CesiumJS app with a Node server. The server is more than a file host: about thirty middleware routes fetch, cache and throttle the data feeds, and they hold any provider keys you add. This template builds the tagged release once and serves the production bundle with Vite's preview server, which runs the same data routes as upstream's Docker image. A small Caddy gateway is the only public endpoint and asks for a password, so nobody can spend your keys. The disk cache (satellite elements, launches, map queries, the TomTom daily budget) lives on a volume, which keeps restarts gentle on the public data providers.
Common Use Cases
- Exploring live air, sea and space traffic on a 3D globe for OSINT and geospatial teaching, demos and video work
- A shared, password-protected situational view for a small team: flights, quakes, storms, launches and public cameras in one place
- Riding along with a live aircraft in cockpit view, or tracking the ISS and other satellites in real time
- A starting point for your own layers: fork the app, point a module at your own data, and deploy it the same way
Dependencies for God's Eye View Hosting
- A browser with WebGL; nothing to install for viewers.
- A volume for the disk cache (included).
- No API keys. Optional keys add capabilities: a free Cesium ion token (photorealistic 3D cities and world terrain, eligible personal non-commercial use), AISStream (ships, free), NASA FIRMS (active fires, free), TomTom (live traffic speeds, free tier), Mapillary (street-level photos, free), OpenSky (more flight polling, free account), Google Maps (direct 3D and place search, metered), OpenAI or Gemini (voice control, metered).
Deployment Dependencies
- God's Eye View on GitHub (MIT for the code; data keeps its own terms)
- Release v0.3.0
- Upstream data sources and their terms and security model
- Cesium ion, AISStream, NASA FIRMS map key, TomTom keys, Mapillary developers, OpenSky Network, Google Maps Platform, OpenAI platform
Implementation Details
| Service | What it does | Public |
|---|---|---|
| gateway | Caddy with a password login; the only public domain | yes |
| gods-eye-view | The app: built bundle plus the data and API routes (vite preview), runs as a non-root user |
no |
| Volume | /app/.gev-cache on gods-eye-view: cached feeds and the TomTom daily budget |
— |
First login
- Wait for both builds. The gods-eye-view build fetches the pinned release and compiles the bundle; it takes a few minutes.
- Open the gateway's variables and copy
GEV_UI_PASSWORD. The user name isadmin(GEV_UI_USERNAME). - Open
https://{your-domain}, sign in, and pick a first-run mission such as Live Contacts. Flights, satellites, earthquakes, cameras and launches work without keys.
Adding keys: set them on the gods-eye-view service and deploy. The in-app POWER UP panel cannot save keys on a hosted server (upstream allows it only on the local machine); Railway variables replace it. CESIUM_ION_TOKEN, GOOGLE_MAPS_API_KEY and MAPILLARY_CLIENT_TOKEN are built into the page, so a deploy rebuilds the bundle; they are visible to everyone who can open the page. Restrict the Google key by HTTP referrer to https://{your-domain}/* and give Cesium ion a public assets:read token with a URL restriction. All other keys stay on the server. Set budgets and usage limits at OpenAI and Google: the app's throttles are not billing caps, and behind the gateway they apply to all users together.
Custom domain: add it to the gateway service, then add it to GEV_ALLOWED_HOSTS on gods-eye-view (comma-separated). The app answers only host names on that list.
Public access: GEV_PUBLIC_ACCESS=true on the gateway removes the login. The app then refuses its paid routes (voice, AI summary, Google place search, Mapillary, TomTom), as it does behind any reverse proxy, but visitors can read the Google Maps and Cesium ion keys from the page. Leave those keys unset, or restricted, for a public globe.
Data terms: every feed keeps its own terms. Among them: OpenSky's licence is non-commercial and anonymous access allows 400 credits a day (each global snapshot costs 4; the app stretches its cache and falls back to adsb.lol); Launch Library 2 allows 15 anonymous calls an hour (cached); the cockpit's Google News headlines are for personal, non-commercial use; the bundled submarine-cable map (CC BY-NC-SA) and Nepal flood scene (CC BY-NC) are non-commercial; DelDOT live video needs DelDOT's agreement beyond personal viewing (CCTV_DELDOT_ENABLED=0 turns it off). Commercial operators should read upstream's DATA_SOURCES.md and get advice before relying on any feed.
Scaling: keep gods-eye-view at one replica (it owns the volume, one AIS stream and the OpenSky credit budget) and give it more memory if ships are on. Raise GEV_RATELIMIT_OPENAI_PER_MIN or GEV_RATELIMIT_GOOGLE_PER_MIN for larger teams. OpenSky OAuth credentials lift the flight budget to 4,000 credits a day.
Versions: the source is pinned to v0.3.0 by commit (GEV_VERSION, GEV_COMMIT build args) on Node 24.22.2 and Caddy 2.11.7. To upgrade, set both variables on gods-eye-view and deploy; the build stops if the commit and version do not match.
God's Eye View shows public and third-party data that can be delayed, incomplete or wrong. Do not use it for navigation, emergency response or other safety-critical decisions.
Why Deploy God's Eye View on Railway?
Railway builds and runs the app, its login gateway and its cache volume from one template, with HTTPS, logs and private networking included. You add keys as variables, pay for the memory and CPU the globe actually uses, and skip running a server of your own.
This is a community template. It is not made, endorsed or supported by the God's Eye View authors or Halfpixel.
View God's Eye View Live Satellite and World Tracker on railway.com
Similar templates
| Template | Category | DeploymentsDeploys |
|---|---|---|
| Umami An open source, privacy-focused alternative to Google Analytics | Analytics | 4,236 |
| Metabase Fast analytics and integrated tooling for companies exploring their data | Analytics | 2,642 |
| Plausible Analytics An easy to use, privacy-friendly, open-source Google Analytics alternative | Analytics | 915 |
| Formbricks An open source surveys & experience management solution | Analytics | 693 |
| SearXNG | Open Source Search API for AI Agents Self-Host SearXNG. Open source, AI-ready search, 70+ engines combined | Analytics | 140 |
| PostHog Product Analytics SuiteTracklayer Self-hosted product analytics, session replay, feature flags and A/B tests. | Analytics | 14 |