rd13_tile_server/docs/homeassistant-config.md

Home Assistant – eigenen Tile-Server verwenden

Home Assistant kann über mehrere Wege eigene Karten-Tiles nutzen.

-------------------------------------------------------------------------

Option 1: Map Card (Standard Lovelace)

-------------------------------------------------------------------------

In einer Lovelace-Dashboard-Karte (type: map) wird der Tile-Server über

ein custom Frontend-Modul eingebunden. Die eingebaute Map-Card unterstützt

ab HA 2024.x direkt eigene Tile-Layer:

Lovelace YAML (Dashboard → Karte bearbeiten → YAML-Modus):

type: map

entities:

- person.YOUR_PERSON

default_zoom: 12

# Tile Layer Override (ab HA 2024.6+):

tile_layer: http://TILE_SERVER_URL:8080/styles/osm-bright/{z}/{x}/{y}.png

tile_layer_attribution: "© OpenMapTiles © OpenStreetMap contributors"

-------------------------------------------------------------------------

Option 2: custom:map-card (HACS)

-------------------------------------------------------------------------

https://github.com/nathan-gs/ha-map-card

type: custom:map-card

x: 48.137

y: 11.576

zoom: 12

tile_layer_url: "http://TILE_SERVER_URL:8080/styles/osm-bright/{z}/{x}/{y}.png"

tile_layer_attribution: "© OpenMapTiles © OpenStreetMap contributors"

tile_layer_max_zoom: 19

entities:

- entity: person.YOUR_PERSON

-------------------------------------------------------------------------

Option 3: Satellitenkarte als alternativer Layer

-------------------------------------------------------------------------

type: custom:map-card

tile_layer_url: "http://TILE_SERVER_URL:8080/styles/satellite-hybrid/{z}/{x}/{y}.png"

tile_layer_attribution: "© OpenMapTiles © Sentinel-2"

-------------------------------------------------------------------------

Hinweise

-------------------------------------------------------------------------

- TILE_SERVER_URL ersetzen mit der IP/Hostname des Tile-Servers im LAN

- Port 8080 ist Standard (nginx-Proxy), anpassen falls abweichend

- CORS ist bereits für das gesamte LAN (Origin: *) konfiguriert

- Home Assistant muss den Tile-Server über HTTP im LAN erreichen können

- Für HTTPS-Setups: Tile-Server ebenfalls über HTTPS erreichbar machen

(z.B. über nginx Reverse Proxy mit SSL-Terminierung)