{"action":"created","issue":{"url":"https://api.github.com/repos/docker/swarm/issues/817","labels_url":"https://api.github.com/repos/docker/swarm/issues/817/labels{/name}","comments_url":"https://api.github.com/repos/docker/swarm/issues/817/comments","events_url":"https://api.github.com/repos/docker/swarm/issues/817/events","html_url":"https://github.com/docker/swarm/issues/817","id":78210552,"number":817,"title":"Feedback: `--addr` is very confusing","user":{"login":"aluzzardi","id":179503,"avatar_url":"https://avatars.githubusercontent.com/u/179503?v=3","gravatar_id":"","url":"https://api.github.com/users/aluzzardi","html_url":"https://github.com/aluzzardi","followers_url":"https://api.github.com/users/aluzzardi/followers","following_url":"https://api.github.com/users/aluzzardi/following{/other_user}","gists_url":"https://api.github.com/users/aluzzardi/gists{/gist_id}","starred_url":"https://api.github.com/users/aluzzardi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aluzzardi/subscriptions","organizations_url":"https://api.github.com/users/aluzzardi/orgs","repos_url":"https://api.github.com/users/aluzzardi/repos","events_url":"https://api.github.com/users/aluzzardi/events{/privacy}","received_events_url":"https://api.github.com/users/aluzzardi/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/docker/swarm/labels/area/doc","name":"area/doc","color":"207de5"},{"url":"https://api.github.com/repos/docker/swarm/labels/kind/help%20wanted","name":"kind/help wanted","color":"159818"},{"url":"https://api.github.com/repos/docker/swarm/labels/kind/question","name":"kind/question","color":"cc317c"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/docker/swarm/milestones/3","html_url":"https://github.com/docker/swarm/milestones/0.3.0","labels_url":"https://api.github.com/repos/docker/swarm/milestones/3/labels","id":1026388,"number":3,"title":"0.3.0","description":"","creator":{"login":"vieux","id":1032519,"avatar_url":"https://avatars.githubusercontent.com/u/1032519?v=3","gravatar_id":"","url":"https://api.github.com/users/vieux","html_url":"https://github.com/vieux","followers_url":"https://api.github.com/users/vieux/followers","following_url":"https://api.github.com/users/vieux/following{/other_user}","gists_url":"https://api.github.com/users/vieux/gists{/gist_id}","starred_url":"https://api.github.com/users/vieux/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vieux/subscriptions","organizations_url":"https://api.github.com/users/vieux/orgs","repos_url":"https://api.github.com/users/vieux/repos","events_url":"https://api.github.com/users/vieux/events{/privacy}","received_events_url":"https://api.github.com/users/vieux/received_events","type":"User","site_admin":false},"open_issues":27,"closed_issues":36,"state":"open","created_at":"2015-03-17T23:46:40Z","updated_at":"2015-05-20T17:35:41Z","due_on":"2015-06-02T07:00:00Z","closed_at":null},"comments":19,"created_at":"2015-05-19T18:58:31Z","updated_at":"2015-05-20T19:15:56Z","closed_at":null,"body":"One of the first steps to set up a cluster is to run `swarm join --addr=<address> <discovery>`.\r\n\r\nMany people mistake `--addr` for the manager address instead of the docker address.\r\n\r\nWe should find an alternative name, perhaps:\r\n- `--cluster-addr`\r\n- `--peer-addr`\r\n- `--my-addr`\r\n- `--engine-addr`\r\n- `--docker-addr`\r\n\r\nAdditionally, perhaps it would help if we'd pre-fill that option. In order to do that, we'd need to run `swarm join` with `--net=host` and grab the default interface's IP address.\r\n\r\nThoughts?"},"comment":{"url":"https://api.github.com/repos/docker/swarm/issues/comments/104001731","html_url":"https://github.com/docker/swarm/issues/817#issuecomment-104001731","issue_url":"https://api.github.com/repos/docker/swarm/issues/817","id":104001731,"user":{"login":"aluzzardi","id":179503,"avatar_url":"https://avatars.githubusercontent.com/u/179503?v=3","gravatar_id":"","url":"https://api.github.com/users/aluzzardi","html_url":"https://github.com/aluzzardi","followers_url":"https://api.github.com/users/aluzzardi/followers","following_url":"https://api.github.com/users/aluzzardi/following{/other_user}","gists_url":"https://api.github.com/users/aluzzardi/gists{/gist_id}","starred_url":"https://api.github.com/users/aluzzardi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aluzzardi/subscriptions","organizations_url":"https://api.github.com/users/aluzzardi/orgs","repos_url":"https://api.github.com/users/aluzzardi/repos","events_url":"https://api.github.com/users/aluzzardi/events{/privacy}","received_events_url":"https://api.github.com/users/aluzzardi/received_events","type":"User","site_admin":false},"created_at":"2015-05-20T19:15:56Z","updated_at":"2015-05-20T19:15:56Z","body":"Thanks for the great feedback!\r\n\r\n/cc @moxiegirl\r\n\r\nTo sum up the conversation:\r\n- Change the flag `--addr` into `--node-addr`, as everyone seems to agree\r\n- Add a good explanation in the docs  of what `node-addr` is - everyone is agreeing as well\r\n- Explain what the port number is conceptually as @squillace mentioned\r\n- Emphasize security, as @UserTaken suggested\r\n\r\nOne think I might add as well, related to the port discussion: step 2 of `Set up Swarm nodes` says to run:\r\n```\r\ndocker -H tcp://0.0.0.0:2375 -d\r\n```\r\n\r\nThat is utterly confusing. It hardcodes the port with no explanation and worst of all people end up running (and failing at doing so) a second instance of docker rather than updating their system configuration to change to start up flags (we simply need them to add `-H tcp://0.0.0.0:<whatever port they like>`). This is tough to document since it's linux distribution specific."}}