bumper/docs/DNS_Setup.md

DNS

You need to configure your router to point DNS locally to where Bumper is running.
The easiest way is overriding the main domains used by EcoVacs using DNSMasq/PiHole, by adding address entries in a custom config.

Custom DNSMasq Config

Typically written at /etc/dnsmasq.d/{##}-{name}.conf - Ex: /etc/dnsmasq.d/02-custom.conf

File Contents:

address=/ecouser.net/{bumper server ip}
address=/ecovacs.com/{bumper server ip}
address=/ecovacs.net/{bumper server ip}

Note: Replace {bumper server ip} with your server's IP

If using PiHole, reload FTL to apply changes: sudo service pihole-FTL reload

Manual Override

If overriding DNS for the top-level domains isn't an option, you'll need to configure your router DNS to point a number of domains used by the app/robot to the Bumper server.

Note: Depending on country, your phone/robot may be using a different domain. Most of these domains contain country-specific placeholders.

Not all domains have been documented at this point, and this list will be updated as more are identified/seen. The preferred way to ensure Bumper works is to override the full domains as above.

• Example: If you see eco-{countrycode}-api.ecovacs.com and you live in the US/North America you would use: eco-us-api.ecovacs.com

Address	Description
lb-{countrycode}.ecovacs.net	Load-balancer that is checked by the app/robot
lb-{countrycode}.ecouser.net	Load-balancer that is checked by the app/robot
lbus.ecouser.net	Load-balancer that is checked by the app/robot
lb{countrycode}.ecouser.net	Load-balancer that is checked by the app/robot
eco-{countrycode}-api.ecovacs.com	Used for Login
gl-{countrycode}-api.ecovacs.com	Used by EcoVacs Home app
gl-{countrycode}-openapi.ecovacs.com	Used by EcoVacs Home app
portal-{countrycode}.ecouser.net	Used for Login and Rest API
portal-ww.ecouser.net	Used for various Rest APIs
msg-{countrycode}.ecouser.net	Used for XMPP
msg-ww.ecouser.net	Used for XMPP
mq-ww.ecouser.net	Used for MQTT
mq-{countrycode}.ecouser.net	Used for MQTT
gl-{countrycode}-api.ecovacs.com	Used by Ecovacs Home app for API
recommender.ecovacs.com	Used by Ecovacs Home app
bigdata-international.ecovacs.com	Telemetry/tracking
bigdata-northamerica.ecovacs.com	Telemetry/tracking
bigdata-{unknown regions}.ecovacs.com	Telemetry/tracking