Network objects show the current networks available to LXD. Creation and / or modification of networks is possible only if ‘network’ LXD API extension is present.

Manager methods

Networks can be queried through the following client manager methods:

  • all() - Retrieve all networks.

  • exists() - See if a profile with a name exists. Returns bool.

  • get() - Get a specific network, by its name.

  • create() - Create a new network. The name of the network is required. description, type and config are optional and the scope of their contents is documented in the LXD documentation.

Network attributes

  • name - The name of the network.

  • description - The description of the network.

  • type - The type of the network.

  • used_by - A list of containers using this network.

  • config - The configuration associated with the network.

  • managed - boolean; whether LXD manages the network.

Network methods

  • rename() - Rename the network.

  • save() - Save the network. This uses the PUT HTTP method and not the PATCH.

  • delete() - Deletes the network.


Network operations follow the same manager-style as other classes. Networks are keyed on a unique name.

>>> network = client.networks.get('lxdbr0')

>>> network
Network(config={"ipv4.address": "", "ipv4.nat": "true", "ipv6.address": "none"}, description="", name="lxdbr0", type="bridge")

>>> print(network)
  "name": "lxdbr0",
  "description": "",
  "type": "bridge",
  "config": {
    "ipv4.address": "",
    "ipv4.nat": "true",
    "ipv6.address": "none"
  "managed": true,
  "used_by": []

The network can then be modified and saved.

>>> network.config['ipv4.address'] = ''

To create a new network, use create() with a name, and optional arguments: description and type and config.

>>> network = client.networks.create(
...     'lxdbr1', description='My new network', type='bridge', config={})