Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Doc error: default listen_address #299

Open
twm opened this issue May 1, 2020 · 3 comments
Open

Doc error: default listen_address #299

twm opened this issue May 1, 2020 · 3 comments

Comments

@twm
Copy link

twm commented May 1, 2020

The readme says:

bind_address : The address to bind on. Defaults to 0.0.0.0

However the actual default is :::

"::", // Listen on all addresses

@johnkeates
Copy link
Contributor

johnkeates commented May 1, 2020

That is mostly correct: the documentation only reflects IPv4, but opening a socket on :: causes it to listen on both IPv4 and IPv6 for all of the addresses on the host. We should probably update the documentation to reflect that. On the other hand, if you don't have IPv6 available it will just listen on IPv4 instead.

@twm
Copy link
Author

twm commented May 1, 2020

Actually, if you have fully disabled the IPv6 stack it will fail to listen. That's what bit us.

@johnkeates
Copy link
Contributor

johnkeates commented May 1, 2020

Ah yeah, the sysctl to completely disable it will probably do that. I've seen the same in FreeIPA for example. A lot of things tend to break when that happens, in most cases it's not needed because you can simply deconfigure all ipv6 from your interfaces to not use ipv6 but leave the stack alive so it can still auto-downgrade to ipv4. Perhaps someone can make it configurable to explicitly listen to ipv4-only for those use cases.

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

No branches or pull requests

2 participants