Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.
Maps and Locations
Open Site settings → Maps and locations. Map display and place-name lookup are configured separately: map tokens load the map, while location services turn photo GPS coordinates into city and country names. Enabling maps cannot add a shooting location to a photo without GPS.
Choose a map service
| Option | Renderer | Default map data | Required credential |
|---|---|---|---|
| MapLibre | Open-source MapLibre GL JS | MapTiler | MapTiler API key for the built-in style |
| Mapbox | Mapbox GL JS | Mapbox | Mapbox public access token |
::: info Renderer and map data service MapLibre is the renderer; MapTiler supplies map data. The built-in MapLibre style follows the site's light/dark theme. A custom style overrides it. Check each provider's current terms, allowances and pricing. :::
<template #maplibre>
MapLibre + MapTiler
- Sign in to MapTiler Cloud.
- Create or copy a key for your gallery on the API keys page.
- Choose MapLibre in ChronoFrame and paste the key into its token field. Leave the style empty to start with the built-in map.
- Set Allowed HTTP origins for the key to your gallery origin, such as
https://gallery.example.com. Addhttp://localhost:3000for local testing. - Save and open the globe or a GPS-tagged photo to check the map.
::: warning Restrict where the key can be used The browser uses this key, so it is not a server-only secret. See the MapTiler API key guide for origin restrictions. :::
Custom styles
Copy a MapLibre-compatible Style JSON URL from the MapTiler map page and enter it in the MapLibre style field, for example:
https://api.maptiler.com/maps/streets-v2/style.json?key=YOUR_MAPTILER_KEY
::: tip Use the Style JSON URL
- Enter a style URL, not a preview page or embedded HTML.
- Use your own key in the URL and check it when rotating keys.
- Self-hosted tiles, fonts and sprites must be accessible to visitors' browsers with appropriate CORS headers.
:::
<template #mapbox>
Mapbox
- Sign in to Mapbox.
- Create a public token on the Access tokens page. It normally starts with
pk.; retain read access needed for map styles, tiles and fonts. - Choose Mapbox in ChronoFrame and enter the public token. Do not enter a secret
sk.token. - Add URL restrictions for the gallery and any local testing address. Create a dedicated token: the default public token cannot have URL restrictions.
- Leave the style empty to use Mapbox Standard. Save and open a map to check the result.
See Mapbox token management for creation and restrictions.
Custom styles
Choose or create a style in Mapbox Studio, copy its Style URL from the sharing panel and enter it in the Mapbox style field:
mapbox://styles/YOUR_USERNAME/YOUR_STYLE_ID
The token must be able to read the style. Do not use the Studio editor URL.
Place-name lookup
Location settings further down the same page include:
- Place-name language: controls names saved by future lookups; reindex existing photo locations to update them.
- Mapbox reverse-geocoding token: used for server requests, independently of the browser map token. URL restrictions can reject server requests, so do not simply reuse an origin-restricted map token.
- Nominatim URL: use it for a self-hosted service or proxy; otherwise keep the default.
MapLibre can display maps while Mapbox or Nominatim identifies places. Troubleshoot map display and place-name lookup separately.
Configure later and troubleshoot
::: tip Configure maps later You can skip the token during setup and add it here later. Uploads and photo management still work. MapLibre views indicate that setup is missing only when neither a token nor a custom style is configured; the built-in MapTiler style requires a key. :::
For blank maps or 401 / 403 responses, check the provider, token, current URL restrictions and access to styles, tiles and fonts. Update origin restrictions when moving from localhost to a public domain.