Webserver-Config

Info:
When a “default” is mentioned for any option, it is meant that if the option is commented out or removed, that is what BlueMap will use as a fallback.
This may not be the same as the option that is pre-filled-in.

enabled

With this setting you can disable the integrated web-server.

This is useful if you want to only render the map-data for later use, or if you have set up your own webserver.

Default is true

webroot

The webroot that the server will host to the web.

Usually this should be set to the same directory like in the webapp.conf!

Default is "bluemap/web"

port

The port that the webserver listens on.

Default is 8100

sse-enabled

Whether to use Server-Sent Events (SSE) for pushing tile and marker-updates to the connected clients.

Default is true

log

Config-section for webserver-activity logging

file

The file where the webserver-activity will be written to.
Comment out to disable the logging completely.

Java String formatting syntax can be used to add time.

Default is no logging

append

Whether the logger should append to an existing file, or overwrite it

Default is false

format

The format of the webserver-activity logs.

The syntax is the Java String formatting.

Possible Arguments:
1 - the source address (ignoring any xff headers)
2 - the source address (using the (leftmost) xff header if provided)
3 - the http-method of the request
4 - the full request-address
5 - the protocol version of the request
6 - the status-code of the response
7 - the status-message of the response

Default is "%1$s \"%3$s %4$s %5$s\" %6$s %7$s"

Hidden Configs

Info:
These config options are not included in bluemaps default configuration template.
This is done to discourage users from changing them, as they rarely need to be changed and are for advanced users only.
Change them at your own risk!

ip

The IP address that the webserver will bind to.

Usually bluemap binds to all available network-interfaces, but you can use this setting to restrict bluemaps webserver to bind to only one ip. For example if you want to only bind it to localhost and disallow external access you can set this to

ip: "127.0.0.1"

Default is 0.0.0.0 (all available interfaces)