github.com/netbrain/docker@v1.9.0-rc2/docs/reference/commandline/network_create.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "network create"
     4  description = "The network create command description and usage"
     5  keywords = ["network, create"]
     6  [menu.main]
     7  parent = "smn_cli"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # network create
    12  
    13      Usage:  docker network create [OPTIONS] NETWORK-NAME
    14  
    15      Creates a new network with a name specified by the user
    16  
    17        -d, --driver=      Driver to manage the Network
    18        --help=false       Print usage
    19  
    20  Creates a new network that containers can connect to. If the driver supports multi-host networking, the created network will be made available across all the hosts in the cluster. Daemon will do its best to identify network name conflicts. But its the users responsibility to make sure network name is unique across the cluster. You create a network and then configure the container to use it, for example:
    21  
    22  ```
    23    $ docker network create -d overlay multi-host-network
    24    $ docker run -itd --net=multi-host-network busybox
    25  ```
    26  
    27  the container will be connected to the network that is created and managed by the driver (multi-host overlay driver in the above example) or external network plugins.
    28  
    29  Multiple containers can be connected to the same network and the containers in the same network will start to communicate with each other. If the driver/plugin supports multi-host connectivity, then the containers connected to the same multi-host network will be able to communicate seamlessly.
    30  
    31  *Note*: UX needs enhancement to accept network options to be passed to the drivers