Client :: tilegroxy Docs

Configuration

Parameter Description Type Required Default

Parameter	Description	Type	Required	Default
`UserAgent`	The user agent to include in outgoing http requests.	string	No	tilegroxy/VERSION
`MaxLength`	The maximum Content-Length to allow incoming responses	int	No	10 MiB
`UnknownLength`	Allow responses that are missing a Content-Length header	bool	No	false
`ContentTypes`	The content-types to allow remote servers to return. Anything else will be interpreted as an error. See Content Type for details	string[]	No	image/png, image/jpg, image/jpeg, application/vnd.mapbox-vector-tile, application/x-protobuf, application/vnd.maplibre-tile, application/vnd.maplibre-vector-tile
`StatusCodes`	The status codes from the remote server to consider successful	int[]	No	200
`Timeout`	How long (in seconds) to wait for a remote server to respond, including reading the body, before giving up and returning an error. 0 disables the timeout, in which case only the server `Timeout` applies	int	No	10
`Headers`	Include these headers in requests	map[string]string	No	None
`RewriteContentTypes`	Replaces `Content-Type`s that match the key with the value. This is to handle servers returning a generic content type. Mapping to an empty string that will cause tilegroxy to intuit the Content-Type by inspecting the contents - this may be inaccurate for MVT and MLT. This only applies after the check that Content-Type is valid according to the `ContentTypes` parameter meaning your original Content-Type will need to be in both parameters to be used	map[string]string	No	{"application/octet-stream": ""}

UserAgent

The user agent to include in outgoing http requests.

string

tilegroxy/VERSION

MaxLength

The maximum Content-Length to allow incoming responses

int

10 MiB

UnknownLength

Allow responses that are missing a Content-Length header

bool

false

ContentTypes

The content-types to allow remote servers to return. Anything else will be interpreted as an error. See Content Type for details

string[]

image/png, image/jpg, image/jpeg, application/vnd.mapbox-vector-tile, application/x-protobuf, application/vnd.maplibre-tile, application/vnd.maplibre-vector-tile

StatusCodes

The status codes from the remote server to consider successful

int[]

200

Timeout

How long (in seconds) to wait for a remote server to respond, including reading the body, before giving up and returning an error. 0 disables the timeout, in which case only the server Timeout applies

int

Headers

Include these headers in requests

map[string]string

None

RewriteContentTypes

Replaces Content-Types that match the key with the value. This is to handle servers returning a generic content type. Mapping to an empty string that will cause tilegroxy to intuit the Content-Type by inspecting the contents - this may be inaccurate for MVT and MLT. This only applies after the check that Content-Type is valid according to the ContentTypes parameter meaning your original Content-Type will need to be in both parameters to be used

map[string]string

{"application/octet-stream": ""}

Environment variables
Configuration Parameter	Environment Variable
`UserAgent`	`CLIENT_USERAGENT`
`MaxLength`	`CLIENT_MAXLENGTH`
`UnknownLength`	`CLIENT_UNKNOWNLENGTH`
`ContentTypes`	`CLIENT_CONTENTTYPES`
`StatusCodes`	`CLIENT_STATUSCODES`
`Timeout`	`CLIENT_TIMEOUT`