Skip to content

Docker: recommend host networking, document device suggestions - #1203

Merged
naltatis merged 2 commits into
mainfrom
docs/docker-host-network
Oct 3, 2026
Merged

naltatis merged 2 commits into
mainfrom
docs/docker-host-network

Conversation

@naltatis

@naltatis naltatis commented Oct 3, 2026

Copy link
Copy Markdown
Member

fixes #1202, refs evcc-io/evcc#34244

The Docker guide treated bridge networking as the standard and only showed host networking in a tab for SMA devices and EEBus. With device suggestions in the host field, host networking has a further benefit, since a container in bridge mode doesn't see the local network.

  • New Network Mode section explains the benefits of host networking (device suggestions, mDNS for EEBus, SMA Sunny Home Manager and the app, UDP devices, no port list) and when bridge networking is fine
  • Installation reordered to Docker Compose, Docker CLI, Docker UI, each with a Host network (recommended) and a Bridge network tab that stay in sync
  • Volumes and ports are explained once, updates are combined into one section, the CLI update steps are added to the English page
  • Examples fixed: comments inside the docker run commands broke them, and the host examples published ports that are ignored in host mode
  • machine-id mount, command and version removed from the examples, port 28376/udp for EVSE Master added
  • Beginners are pointed to a Raspberry Pi with the ready-made image instead of the Linux or macOS guide
  • Advanced section at the end of the page for EVCC_DISCOVERY_HOSTS, a static device list for controlled bridge setups
  • Configuration page describes the device suggestions in the IP address or hostname field
  • Considerations page no longer asks to collect all IP addresses from the router beforehand

@naltatis
naltatis requested a review from andig October 3, 2026 11:07
Comment thread src/content/docs/de/installation/configuration.mdx Outdated
@naltatis
naltatis enabled auto-merge (squash) October 3, 2026 13:21
@naltatis
naltatis merged commit af32547 into main Oct 3, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document: Config: suggest local network hosts for device templates

2 participants