Why are browser caching headers are not sent?

[firstdorsal]

Neither in curl nor in the browser caching headers are sent:

curl -v http://omniviv-tiles.localhost/germany/13/4342/2835

* Host omniviv-tiles.localhost:80 was resolved.
* IPv6: ::1
* IPv4: 127.0.0.1
*   Trying [::1]:80...
* Established connection to omniviv-tiles.localhost (::1 port 80) from ::1 port 58172 
* using HTTP/1.x
> GET /germany/13/4342/2835 HTTP/1.1
> Host: omniviv-tiles.localhost
> User-Agent: curl/8.17.0
> Accept: */*
> 
* Request completely sent off
< HTTP/1.1 200 OK
< Content-Type: application/x-protobuf
< Date: Wed, 14 Jan 2026 20:24:45 GMT
< Etag: "MD6Hc2POBwTyzdhPNnIJFg"
< Vary: Origin, Access-Control-Request-Method, Access-Control-Request-Headers
< Transfer-Encoding: chunked
< 
Warning: Binary output can mess up your terminal. Use "--output -" to tell curl to output 
Warning: it to your terminal anyway, or consider "--output <FILE>" to save to a file.
* client returned ERROR on write of 4090 bytes
* Failed reading the chunked-encoded stream
* closing connection #0

[2026-01-14T19:03:33Z INFO  martin] Starting Martin v1.1.0
[2026-01-14T19:03:33Z INFO  martin] Config file is not specified, auto-detecting sources
[2026-01-14T19:03:33Z WARN  martin::config::file::tiles::pmtiles] Defaulting `pmtiles.allow_http` to `true`. This is likely to become an error in the future for better security.
[2026-01-14T19:03:33Z INFO  martin::config::file::cache] Initializing PMTiles directory cache with maximum size 128 MB
[2026-01-14T19:03:33Z INFO  martin::config::file::file_config] Configured source germany from /mbtiles/germany.mbtiles
[2026-01-14T19:03:33Z INFO  martin::config::file::cache] Initializing tile cache with maximum size 256 MB
[2026-01-14T19:03:33Z INFO  martin::config::file::cache] Initializing sprite cache with maximum size 64 MB
[2026-01-14T19:03:33Z INFO  martin_core::resources::fonts] Configured font Open Sans Bold with 1010 glyphs (0000-FFFD) from /fonts/OpenSans-Bold.ttf
[2026-01-14T19:03:33Z INFO  martin_core::resources::fonts] Configured font Open Sans Regular with 1010 glyphs (0000-FFFD) from /fonts/OpenSans-Regular.ttf
[2026-01-14T19:03:33Z INFO  martin::config::file::cache] Initializing font cache with maximum size 64 MB
[2026-01-14T19:03:33Z INFO  martin] Use --save-config to save or print Martin configuration.
[2026-01-14T19:03:33Z INFO  martin::config::file::cors] CORS enabled with defaults: CorsProperties { origin: ["*"], max_age: None, unrecognized: {} }
[2026-01-14T19:03:33Z INFO  martin] Martin has been started on 0.0.0.0:3000.
[2026-01-14T19:03:33Z INFO  martin] Use http://0.0.0.0:3000/catalog to get the list of available sources.
[2026-01-14T19:03:33Z INFO  martin] Web UI is disabled. Use `--webui enable-for-all` in CLI or a config value to enable it for all connections.

    martin:
        image: ghcr.io/maplibre/martin
        container_name: omniviv-martin
        restart: unless-stopped
        volumes:
        - ./data//mbtiles:/mbtiles:ro
        - ./data//fonts:/fonts:ro
        - ./data//sprites:/sprites:ro
        command: /mbtiles --font /fonts
        networks:
        - rp
        labels:
          traefik.docker.network: rp
          traefik.enable: true
          traefik.http.routers.omniviv-martin.rule: Host(`omniviv-tiles.localhost`)
          traefik.http.routers.omniviv-martin.entrypoints: web
          traefik.http.routers.omniviv-martin.service: omniviv-martin
          traefik.http.services.omniviv-martin.loadbalancer.server.port: '3000'
    traefik:
        image: traefik:v3
        container_name: omniviv-traefik
        restart: unless-stopped
        command:
        - --providers.docker=true
        - --entrypoints.web.address=:80
        networks:
        - rp
        ports:
        - 80:80
        volumes:
        - /var/run/docker.sock:/var/run/docker.sock:ro

Sending to port, not through traefik

❯ curl -v http://localhost:7070/germany/12/2171/1415
* Host localhost:7070 was resolved.
* IPv6: ::1
* IPv4: 127.0.0.1
*   Trying [::1]:7070...
* Established connection to localhost (::1 port 7070) from ::1 port 48356 
* using HTTP/1.x
> GET /germany/12/2171/1415 HTTP/1.1
> Host: localhost:7070
> User-Agent: curl/8.17.0
> Accept: */*
> 
* Request completely sent off
< HTTP/1.1 200 OK
< content-length: 36440
< content-type: application/x-protobuf
< etag: "wzl0UaDrHuZC-u9xdlui0w"
< vary: Origin, Access-Control-Request-Method, Access-Control-Request-Headers
< date: Wed, 14 Jan 2026 20:36:26 GMT
< 
Warning: Binary output can mess up your terminal. Use 
Warning: "--output -" to tell curl to output it to 
Warning: your terminal anyway, or consider "--output 
Warning: <FILE>" to save to a file.
* client returned ERROR on write of 16384 bytes
* closing connection #0

[CommanderStorm]

Why are browser caching headers are not sent?

We don't know what the browser caching headers should be.
We set an etag, that is sort of an caching header, but not really.

How would we know which headers you want?
-> We currently have no way of knowing what you want in this case, so are not ataching any.

I have not invested time in how this should work.
-> To add this, the first step would be a design issue on how such a feature should work.
Aka, which things should be configurable how.
For example

• are the caching headers for tiles configrable separtely from sprites?
• where are these properties located?
• ...

[firstdorsal]

Having a config option to add an x second caching time to all resources would be a start.

[nyurik]

there is a #749 ticket for this - I agree we need this, lets figure out the config values and add that