---
title: Integrating Docker via the Network Plugin (V2)
menu_order: 20
search_type: Documentation
---

 * [Installation](#installation)
 * [Configuring the Plugin](#configuring)
 * [Running Services or Containers Using the Plugin](#usage)

Docker Engine version 1.12 introduced [a new plugin system (V2)](https://docs.docker.com/engine/extend/).
This document describes how to use [the Network Plugin V2 of Weave Net](https://store.docker.com/plugins/weave-net-plugin).

Before using the plugin, please keep in mind the plugin works only in Swarm
mode and requires Docker version 1.13 or later.

### <a name="installation"></a>Installation

To install the plugin run the following command on _each_ host already
participating in a Swarm cluster, i.e. on all master and worker nodes:

    $ docker plugin install store/weaveworks/net-plugin:latest_release

Docker will pull the plugin from Docker Store, and it will ask to grant
privileges before installing the plugin. Afterwards, it will start `weaver`
process which will try to connect to Swarm masters running Weave Net.

### <a name="configuring"></a>Configuring the Plugin

There are several configuration parameters which can be set with:

    $ docker plugin set store/weaveworks/net-plugin:latest_release PARAM=VALUE

The parameters include:

* `WEAVE_PASSWORD` - if non empty, it will instruct Weave Net to encrypt
   traffic - see [here](/site/tasks/manage/security-untrusted-networks.md) for
   more details.
* `WEAVE_MULTICAST` - set to 1 on each host running the plugin to enable
  multicast traffic on any Weave Net network.
* `WEAVE_MTU` - Weave Net defaults to 1376 bytes, but you can set a
  smaller size if your underlying network has a tighter limit, or set
  a larger size for better performance if your network supports jumbo
  frames - see [here](/site/tasks/manage/fastdp.md#mtu) for more
  details.
* `IPALLOC_RANGE` - the range of IP addresses used by Weave Net and the subnet
  they are placed in (CIDR format; default 10.32.0.0/12).
  See [here](/site/tasks/ipam/configuring-weave.md) for more details.

Before setting any parameter, the plugin has to be disabled with:

    $ docker plugin disable store/weaveworks/net-plugin:latest_release

To re-enable the plugin run the following command:

    $ docker plugin enable store/weaveworks/net-plugin:latest_release

### <a name="usage"></a>Running Services or Containers Using the Plugin

After you have launched the plugin, you can create a network for Docker Swarm
services by running the following command on any Docker Swarm master node:

    $ docker network create --driver=store/weaveworks/net-plugin:latest_release mynetwork

Or you can create a network for any Docker container with:

    $ docker network create --driver=store/weaveworks/net-plugin:latest_release --attachable mynetwork

To start a service attached to the network run, for example:

    $ docker service create --network=mynetwork ...

Or to start a container:

    $ docker run --network=mynetwork ...

**See Also**

 * [Integrating Docker via the Network Plugin (Legacy)](/site/install/plugin/plugin.md)
 * [How the Weave Network Plugins Work](/site/install/plugin/plugin-how-it-works.md)
 * [Troubleshooting the V2 plugin](/site/troubleshooting.md#v2plugin)