Bumper's behavior can be tailored by setting environment variables before startup.
Below is a list of all variables that the Python application reads, grouped by category.
Variables not listed here are hardcoded or not configurable via environment.
IP address or hostname to bind all server listeners (Web, MQTT, XMPP).
BUMPER_ANNOUNCE_IP
${BUMPER_LISTEN}
IP advertised to robots. If 0.0.0.0, set explicitly.
WEB_SERVER_HTTPS_PORT
443
Port for the HTTPS web UI and API.
WEB_SERVER_LISTEN_PORT
8007
Port for the plain HTTP web UI and API.
MQTT_LISTEN_PORT
1883
Plain MQTT listener.
MQTT_LISTEN_PORT_TLS
8883
TLS MQTT listener.
XMPP_LISTEN_PORT_TLS
5223
TLS XMPP listener.
HELPER_BOT_TIMEOUT
10
Seconds the helper bot waits for a robot to answer. The app gives up on a request after 15 seconds, so a longer wait is never seen by it.
CODEPUSH_LOCAL_PACKAGE
false
Serve the CodePush package from this server instead of the cloud. The app then downloads it from the host of the CodePush service, which has to be one that the DNS override points at Bumper.
These additional environment variables are used in the compose files to control service deployment and container behavior.
Variable
Default
Description
ENV_FILE
.env
File the containers read their environment from.
NODE_ROLE
manager
Docker Swarm role constraint for service placement (manager or worker).
NETWORK_MODE
bridge
Docker network driver (bridge or overlay).
RESOURCES_LIMITS_CPUS
1
CPU limit per container.
RESOURCES_LIMITS_MEMORY
500m
Memory limit per container.
RESOURCES_RESERVATIONS_CPUS
0.001
CPU reservation per container.
RESOURCES_RESERVATIONS_MEMORY
32m
Memory reservation per container.
VERSION_BUMPER
latest
Bumper image tag to deploy. The image reports its build version under the same name.
VERSION_NGNIX
1.29-alpine3.22-slim
NGINX image tag for the reverse proxy.
TZ
Europe/Berlin
Timezone inside containers (binds to host timezone).
BUMPER_ANNOUNCE_IP
required
IP advertised to robots. The shipped Compose files refuse to start when it is unset; outside them it falls back to BUMPER_LISTEN.
BUMPER_LISTEN
0.0.0.0
Bind interface inside the container for Bumper listeners.
DEBUG_BUMPER_LEVEL
INFO
Logging level inside containers.
DEBUG_BUMPER_VERBOSE
1
Verbose detail per log line inside containers.
PROTOCOL
https
Scheme the nginx health check uses against healthcheck.ecouser.net.
LB_SWARM
true
Serve the Traefik routers through the Swarm load balancer.
TRAEFIK_ENTRYPOINT
https
Traefik entrypoint the Bumper routers attach to.
The optional stacks keep their own variables in their Compose file:
docker-compose-zensical.yaml uses VERSION_ZENSICAL, ZENSICAL_PORT,
ZENSICAL_MAIN_PATH, MIKE_PORT, MIKE_BRANCH, MIKE_RELEASE_TAG and
DOCS_UID/DOCS_GID, and docker-compose-mitm.yaml uses
VERSION_MITMPROXY, MITM_PATH and MITM_WEB_PW.