pyveth - veth driver for Docker Engine written in Python
Jacek Kowalski
2026-03-12 e1ee59f176c2acb01eefa8b83e54e1d0377930b1
README.md
@@ -6,9 +6,12 @@
It should be a drop-in replacement for macvlan module.
![Build status](https://github.com/jacekkow/docker-plugin-pyveth/workflows/Release/badge.svg)
## Installation
Plugin is packaged as [Docker Engine-managed plugin](https://docs.docker.com/engine/extend/).
Check out [plugin page on Docker Hub](https://hub.docker.com/p/jacekkow/pyveth).
To install it simply run:
@@ -28,13 +31,32 @@
One will be pushed inside the container and another will remain on host
(without any IP assigned).
Plugin accepts optional `parent` parameter, which is be a name of bridge
interface that the second interface should be added to:
## Options
To use options, add `--opt option=value` as an argument of `docker network create`:
```bash
docker network create --driver jacekkow/pyveth:latest --opt parent=br0 new-network
```
Available options:
`parent=brname`
Automatically attach host interface to the bridge interface `brname`.
`nogw=1`
Disable assignment of gateway IP.
`nogw4=1`
Disable assignment of IPv4 gateway IP.
`nogw6=1`
Disable assignment of IPv6 gateway IP.
## Manual packaging
In order to test this module in development environment, you can build it
@@ -42,5 +64,3 @@
You can also use `package.sh` helper script which will perform
all the steps (including installation) automatically.