Troubleshooting guide.

Error “bind: can’t assign requested address”

BSD hosts including macOS may face listen tcp bind: can't assign requested address error, because BSDs only enable as the loopback address by default.

A workaround is to run sudo ifconfig lo0 alias

Solaris seems to require a similar workaround. (Help wanted.)

Also, gVisor is known to have a similar issue as of October 2020: A workaround on gVisor is to run ip addr add dev lo.

Error “yaml: line N: found character that cannot start any token”

You might be mixing up tabs and spaces in the YAML.

Last modified October 29, 2020: update docs (7927926)