#Connect Loki

This guide covers what to put into the connector form for Grafana Loki.

#1. Find the API URL

Use the base URL of the Loki HTTP API, with no path. Heplon appends /loki/api/v1/... itself.

https://loki.example.com

The URL must be reachable from the internet.

#2. Decide whether you need to set a bearer token

Loki has no authentication of its own. Leave the token field blank when the URL points at Loki directly.

Since the Loki endpoint is reachable from the internet, the URL likely points at a proxy in front of Loki and it requires a bearer token. For example:

• an authenticating reverse proxy (nginx, Envoy, oauth2-proxy) in front of Loki,
• a Loki gateway behind such a proxy.

Heplon sends the token as Authorization: Bearer <token>. A service that expects basic auth (such as Grafana Cloud) is currently not supported. We will add support once the first customer asks for it.

#3. Fill in the form

In Heplon, open Connectors, select Add connector, then Loki.

Loki is now connected to Heplon.

#Notes

• Heplon supports single-tenant Loki only — the default, where auth_enabled is false. Heplon never sends an X-Scope-OrgID header.