Feedback: Deploy CockroachDB On-Premises about docs HOT 3 OPEN

I was just watching a user start a node using the syntax provided on this page:

cockroach start --certs-dir=certs --advertise-addr=<node1 address> --join=<node1 address>,<node2 address>,<node3 address> --cache=.25 --max-sql-memory=.25 --background

And the node was actually still listening on port 26257, the default if --listen-addr isn't specified (he had used the host:port syntax). I think, for this example, it's more helpful to either use --listen-addr alone, or to include it as well as --advertise-addr.

from docs.

Shannon Bradshaw (shannonbradshaw) commented:
Michael Goddard any more detail you can provide here?

from docs.

Sure, and apologies for the delay. My point above was that the startup command, as shown, could lead a user to expect that the node will listen on the address provided to the --advertise-addr= flag and be puzzled when that doesn't happen. My suggestion was to alter this example and provide the --listen-addr= flag instead.

from docs.