homepage-Mirror/docs/widgets/services/gluetun.md

title, description

title	description
Gluetun	Gluetun Widget Configuration

Learn more about Gluetun.

!!! note

Requires [HTTP control server options](https://github.com/qdm12/gluetun-wiki/blob/main/setup/advanced/control-server.md) to be enabled. By default this runs on port `8000`.

Allowed fields: ["public_ip", "region", "country", "port_forwarded"].

To setup authentication, follow the official Gluetun documentation. Note that to use the api key method, you must add the route GET /v1/publicip/ip to the routes array in your Gluetun config.toml.

widget:
  type: gluetun
  url: http://gluetun.host.or.ip:port
  key: gluetunkey # Not required if /v1/publicip/ip endpoint is configured with `auth = none`