1. Packages
  2. Packages
  3. Proxmox Virtual Environment (Proxmox VE)
  4. API Docs
  5. sdn
  6. sdn/controller
  7. Evpn
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.2.1
published on Wednesday, May 20, 2026 by Daniel Muehlbachler-Pietrzykowski
Schema (JSON)
muhlba91/pulumi-proxmoxve

proxmoxve.sdn/controller.Evpn

proxmoxve logo
Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.2.1
published on Wednesday, May 20, 2026 by Daniel Muehlbachler-Pietrzykowski
Schema (JSON)
muhlba91/pulumi-proxmoxve

    The EVPN zone requires an external controller to manage the control plane. The EVPN controller plugin configures the Free Range Routing (frr) router.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as proxmoxve from "@muhlba91/pulumi-proxmoxve";

const finalizer = new proxmoxve.sdn.Applier("finalizer", {});
// SDN Controller (EVPN) - Example configuration for SDN Controller with fabric
const exampleFabric = new proxmoxve.sdn.fabric.Openfabric("example_fabric", {
    resourceId: "main",
    ipPrefix: "10.0.0.0/16",
}, {
    dependsOn: [finalizer],
});
const exampleControllerEvpn = new proxmoxve.sdn.controller.Evpn("example_controller_evpn", {
    sdnControllerEvpnId: "evpn1",
    asn: 65000,
    fabric: exampleFabric.resourceId,
}, {
    dependsOn: [finalizer],
});
const controllerApplier = new proxmoxve.sdn.Applier("controller_applier", {}, {
    dependsOn: [exampleControllerEvpn],
});

    import pulumi
import pulumi_proxmoxve as proxmoxve

finalizer = proxmoxve.sdn.Applier("finalizer")
# SDN Controller (EVPN) - Example configuration for SDN Controller with fabric
example_fabric = proxmoxve.sdn.fabric.Openfabric("example_fabric",
    resource_id="main",
    ip_prefix="10.0.0.0/16",
    opts = pulumi.ResourceOptions(depends_on=[finalizer]))
example_controller_evpn = proxmoxve.sdn.controller.Evpn("example_controller_evpn",
    sdn_controller_evpn_id="evpn1",
    asn=65000,
    fabric=example_fabric.resource_id,
    opts = pulumi.ResourceOptions(depends_on=[finalizer]))
controller_applier = proxmoxve.sdn.Applier("controller_applier", opts = pulumi.ResourceOptions(depends_on=[example_controller_evpn]))

    package main

import (
	"github.com/muhlba91/pulumi-proxmoxve/sdk/v8/go/proxmoxve/sdn"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		finalizer, err := sdn.NewApplier(ctx, "finalizer", nil)
		if err != nil {
			return err
		}
		// SDN Controller (EVPN) - Example configuration for SDN Controller with fabric
		exampleFabric, err := sdn.NewOpenfabric(ctx, "example_fabric", &sdn.OpenfabricArgs{
			ResourceId: pulumi.String("main"),
			IpPrefix:   pulumi.String("10.0.0.0/16"),
		}, pulumi.DependsOn([]pulumi.Resource{
			finalizer,
		}))
		if err != nil {
			return err
		}
		exampleControllerEvpn, err := sdn.NewEvpn(ctx, "example_controller_evpn", &sdn.EvpnArgs{
			SdnControllerEvpnId: pulumi.String("evpn1"),
			Asn:                 pulumi.Int(65000),
			Fabric:              exampleFabric.ResourceId,
		}, pulumi.DependsOn([]pulumi.Resource{
			finalizer,
		}))
		if err != nil {
			return err
		}
		_, err = sdn.NewApplier(ctx, "controller_applier", nil, pulumi.DependsOn([]pulumi.Resource{
			exampleControllerEvpn,
		}))
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using ProxmoxVE = Pulumi.ProxmoxVE;

return await Deployment.RunAsync(() => 
{
    var finalizer = new ProxmoxVE.Sdn.Applier("finalizer");

    // SDN Controller (EVPN) - Example configuration for SDN Controller with fabric
    var exampleFabric = new ProxmoxVE.Sdn.Fabric.Openfabric("example_fabric", new()
    {
        ResourceId = "main",
        IpPrefix = "10.0.0.0/16",
    }, new CustomResourceOptions
    {
        DependsOn =
        {
            finalizer,
        },
    });

    var exampleControllerEvpn = new ProxmoxVE.Sdn.Controller.Evpn("example_controller_evpn", new()
    {
        SdnControllerEvpnId = "evpn1",
        Asn = 65000,
        Fabric = exampleFabric.ResourceId,
    }, new CustomResourceOptions
    {
        DependsOn =
        {
            finalizer,
        },
    });

    var controllerApplier = new ProxmoxVE.Sdn.Applier("controller_applier", new()
    {
    }, new CustomResourceOptions
    {
        DependsOn =
        {
            exampleControllerEvpn,
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import io.muehlbachler.pulumi.proxmoxve.sdn.Applier;
import io.muehlbachler.pulumi.proxmoxve.sdn.Openfabric;
import io.muehlbachler.pulumi.proxmoxve.sdn.OpenfabricArgs;
import io.muehlbachler.pulumi.proxmoxve.sdn.Evpn;
import io.muehlbachler.pulumi.proxmoxve.sdn.EvpnArgs;
import io.muehlbachler.pulumi.proxmoxve.sdn.ApplierArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var finalizer = new Applier("finalizer");

        // SDN Controller (EVPN) - Example configuration for SDN Controller with fabric
        var exampleFabric = new Openfabric("exampleFabric", OpenfabricArgs.builder()
            .resourceId("main")
            .ipPrefix("10.0.0.0/16")
            .build(), CustomResourceOptions.builder()
                .dependsOn(finalizer)
                .build());

        var exampleControllerEvpn = new Evpn("exampleControllerEvpn", EvpnArgs.builder()
            .sdnControllerEvpnId("evpn1")
            .asn(65000)
            .fabric(exampleFabric.resourceId())
            .build(), CustomResourceOptions.builder()
                .dependsOn(finalizer)
                .build());

        var controllerApplier = new Applier("controllerApplier", ApplierArgs.Empty, CustomResourceOptions.builder()
            .dependsOn(exampleControllerEvpn)
            .build());

    }
}

    resources:
  # SDN Controller (EVPN) - Example configuration for SDN Controller with fabric
  exampleFabric:
    type: proxmoxve:sdn/fabric:Openfabric
    name: example_fabric
    properties:
      resourceId: main
      ipPrefix: 10.0.0.0/16
    options:
      dependsOn:
        - ${finalizer}
  exampleControllerEvpn:
    type: proxmoxve:sdn/controller:Evpn
    name: example_controller_evpn
    properties:
      sdnControllerEvpnId: evpn1
      asn: 65000
      fabric: ${exampleFabric.resourceId}
    options:
      dependsOn:
        - ${finalizer}
  controllerApplier:
    type: proxmoxve:sdn:Applier
    name: controller_applier
    options:
      dependsOn:
        - ${exampleControllerEvpn}
  finalizer:
    type: proxmoxve:sdn:Applier

    Example coming soon!

    Create Evpn Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Evpn(name: string, args: EvpnArgs, opts?: CustomResourceOptions);
    @overload
def Evpn(resource_name: str,
         args: EvpnArgs,
         opts: Optional[ResourceOptions] = None)

@overload
def Evpn(resource_name: str,
         opts: Optional[ResourceOptions] = None,
         asn: Optional[int] = None,
         sdn_controller_evpn_id: Optional[str] = None,
         fabric: Optional[str] = None,
         peers: Optional[Sequence[str]] = None)
    func NewEvpn(ctx *Context, name string, args EvpnArgs, opts ...ResourceOption) (*Evpn, error)
    public Evpn(string name, EvpnArgs args, CustomResourceOptions? opts = null)
    public Evpn(String name, EvpnArgs args)
public Evpn(String name, EvpnArgs args, CustomResourceOptions options)

    type: proxmoxve:sdn/controller/evpn:Evpn
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "proxmoxve_sdn_controller_evpn" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args EvpnArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args EvpnArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args EvpnArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EvpnArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EvpnArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Evpn Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Evpn resource accepts the following input properties:

    Asn int
    Autonomous System Number for the EVPN controller.
    SdnControllerEvpnId string
    The SDN controller object identifier.
    Fabric string
    ID of the fabric this EVPN controller belongs to.
    Peers List<string>
    Set of BGP peer IP addresses for the EVPN controller.
    Asn int
    Autonomous System Number for the EVPN controller.
    SdnControllerEvpnId string
    The SDN controller object identifier.
    Fabric string
    ID of the fabric this EVPN controller belongs to.
    Peers []string
    Set of BGP peer IP addresses for the EVPN controller.
    asn number
    Autonomous System Number for the EVPN controller.
    sdn_controller_evpn_id string
    The SDN controller object identifier.
    fabric string
    ID of the fabric this EVPN controller belongs to.
    peers list(string)
    Set of BGP peer IP addresses for the EVPN controller.
    asn Integer
    Autonomous System Number for the EVPN controller.
    sdnControllerEvpnId String
    The SDN controller object identifier.
    fabric String
    ID of the fabric this EVPN controller belongs to.
    peers List<String>
    Set of BGP peer IP addresses for the EVPN controller.
    asn number
    Autonomous System Number for the EVPN controller.
    sdnControllerEvpnId string
    The SDN controller object identifier.
    fabric string
    ID of the fabric this EVPN controller belongs to.
    peers string[]
    Set of BGP peer IP addresses for the EVPN controller.
    asn int
    Autonomous System Number for the EVPN controller.
    sdn_controller_evpn_id str
    The SDN controller object identifier.
    fabric str
    ID of the fabric this EVPN controller belongs to.
    peers Sequence[str]
    Set of BGP peer IP addresses for the EVPN controller.
    asn Number
    Autonomous System Number for the EVPN controller.
    sdnControllerEvpnId String
    The SDN controller object identifier.
    fabric String
    ID of the fabric this EVPN controller belongs to.
    peers List<String>
    Set of BGP peer IP addresses for the EVPN controller.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Evpn resource produces the following output properties:

    Digest string
    Digest of the controller section.
    Id string
    The provider-assigned unique ID for this managed resource.
    Digest string
    Digest of the controller section.
    Id string
    The provider-assigned unique ID for this managed resource.
    digest string
    Digest of the controller section.
    id string
    The provider-assigned unique ID for this managed resource.
    digest String
    Digest of the controller section.
    id String
    The provider-assigned unique ID for this managed resource.
    digest string
    Digest of the controller section.
    id string
    The provider-assigned unique ID for this managed resource.
    digest str
    Digest of the controller section.
    id str
    The provider-assigned unique ID for this managed resource.
    digest String
    Digest of the controller section.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing Evpn Resource

    Get an existing Evpn resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: EvpnState, opts?: CustomResourceOptions): Evpn
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        asn: Optional[int] = None,
        digest: Optional[str] = None,
        fabric: Optional[str] = None,
        peers: Optional[Sequence[str]] = None,
        sdn_controller_evpn_id: Optional[str] = None) -> Evpn
    func GetEvpn(ctx *Context, name string, id IDInput, state *EvpnState, opts ...ResourceOption) (*Evpn, error)
    public static Evpn Get(string name, Input<string> id, EvpnState? state, CustomResourceOptions? opts = null)
    public static Evpn get(String name, Output<String> id, EvpnState state, CustomResourceOptions options)
    resources:  _:    type: proxmoxve:sdn/controller/evpn:Evpn    get:      id: ${id}
    import {
  to = proxmoxve_sdn_controller_evpn.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Asn int
    Autonomous System Number for the EVPN controller.
    Digest string
    Digest of the controller section.
    Fabric string
    ID of the fabric this EVPN controller belongs to.
    Peers List<string>
    Set of BGP peer IP addresses for the EVPN controller.
    SdnControllerEvpnId string
    The SDN controller object identifier.
    Asn int
    Autonomous System Number for the EVPN controller.
    Digest string
    Digest of the controller section.
    Fabric string
    ID of the fabric this EVPN controller belongs to.
    Peers []string
    Set of BGP peer IP addresses for the EVPN controller.
    SdnControllerEvpnId string
    The SDN controller object identifier.
    asn number
    Autonomous System Number for the EVPN controller.
    digest string
    Digest of the controller section.
    fabric string
    ID of the fabric this EVPN controller belongs to.
    peers list(string)
    Set of BGP peer IP addresses for the EVPN controller.
    sdn_controller_evpn_id string
    The SDN controller object identifier.
    asn Integer
    Autonomous System Number for the EVPN controller.
    digest String
    Digest of the controller section.
    fabric String
    ID of the fabric this EVPN controller belongs to.
    peers List<String>
    Set of BGP peer IP addresses for the EVPN controller.
    sdnControllerEvpnId String
    The SDN controller object identifier.
    asn number
    Autonomous System Number for the EVPN controller.
    digest string
    Digest of the controller section.
    fabric string
    ID of the fabric this EVPN controller belongs to.
    peers string[]
    Set of BGP peer IP addresses for the EVPN controller.
    sdnControllerEvpnId string
    The SDN controller object identifier.
    asn int
    Autonomous System Number for the EVPN controller.
    digest str
    Digest of the controller section.
    fabric str
    ID of the fabric this EVPN controller belongs to.
    peers Sequence[str]
    Set of BGP peer IP addresses for the EVPN controller.
    sdn_controller_evpn_id str
    The SDN controller object identifier.
    asn Number
    Autonomous System Number for the EVPN controller.
    digest String
    Digest of the controller section.
    fabric String
    ID of the fabric this EVPN controller belongs to.
    peers List<String>
    Set of BGP peer IP addresses for the EVPN controller.
    sdnControllerEvpnId String
    The SDN controller object identifier.

    Import

    !/usr/bin/env sh SDN controller can be imported using its unique identifier (controller ID)

    $ pulumi import proxmoxve:sdn/controller/evpn:Evpn example_controller_evpn evpn1

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    proxmoxve muhlba91/pulumi-proxmoxve
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the proxmox Terraform Provider.
    proxmoxve logo
    Viewing docs for Proxmox Virtual Environment (Proxmox VE) v8.2.1
    published on Wednesday, May 20, 2026 by Daniel Muehlbachler-Pietrzykowski
    Schema (JSON)
    muhlba91/pulumi-proxmoxve
      Try Pulumi Cloud free. Your team will thank you.