github.com/noxiouz/docker@v0.7.3-0.20160629055221-3d231c78e8c5/docs/reference/commandline/swarm_join.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "swarm join"
     4  description = "The swarm join command description and usage"
     5  keywords = ["swarm, join"]
     6  advisory = "rc"
     7  [menu.main]
     8  parent = "smn_cli"
     9  +++
    10  <![end-metadata]-->
    11  
    12  # swarm join
    13  
    14  	Usage:	docker swarm join [OPTIONS] HOST:PORT
    15  
    16  	Join a Swarm as a node and/or manager.
    17  
    18  	Options:
    19  	      --help                Print usage
    20  	      --listen-addr value   Listen address (default 0.0.0.0:2377)
    21  	      --manager             Try joining as a manager.
    22  	      --secret string       Secret for node acceptance
    23  
    24  Join a node to a Swarm cluster. If the `--manager` flag is specified, the docker engine
    25  targeted by this command becomes a `manager`. If it is not specified, it becomes a `worker`.
    26  
    27  ### Join a node to swarm as a manager
    28  
    29  ```bash
    30  $ docker swarm join --manager --listen-addr 192.168.99.122:2377 192.168.99.121:2377
    31  This node joined a Swarm as a manager.
    32  $ docker node ls
    33  ID                           NAME      MEMBERSHIP  STATUS  AVAILABILITY  MANAGER STATUS         LEADER
    34  dkp8vy1dq1kxleu9g4u78tlag *  manager2  Accepted    Ready   Active        Reachable
    35  dvfxp4zseq4s0rih1selh0d20    manager1  Accepted    Ready   Active        Reachable              Yes
    36  ```
    37  
    38  ### Join a node to swarm as a worker
    39  
    40  ```bash
    41  $ docker swarm join --listen-addr 192.168.99.123:2377 192.168.99.121:2377
    42  This node joined a Swarm as a worker.
    43  $ docker node ls
    44  ID                           NAME      MEMBERSHIP  STATUS  AVAILABILITY  MANAGER STATUS         LEADER
    45  7ln70fl22uw2dvjn2ft53m3q5    worker2   Accepted    Ready   Active
    46  dkp8vy1dq1kxleu9g4u78tlag    worker1   Accepted    Ready   Active        Reachable
    47  dvfxp4zseq4s0rih1selh0d20 *  manager1  Accepted    Ready   Active        Reachable              Yes
    48  ```
    49  
    50  ### `--manager`
    51  
    52  Joins the node as a manager
    53  
    54  ### `--listen-addr value`
    55  
    56  The node listens for inbound Swarm manager traffic on this IP:PORT
    57  
    58  ### `--secret string`
    59  
    60  Secret value required for nodes to join the swarm
    61  
    62  
    63  ## Related information
    64  
    65  * [swarm init](swarm_init.md)
    66  * [swarm leave](swarm_leave.md)
    67  * [swarm update](swarm_update.md)