add method to set a fixed container mac address

src/Testcontainers/Builders/ITestcontainersBuilder.cs

@@ -69,6 +69,14 @@ public interface ITestcontainersBuilder<out TDockerContainer> : IAbstractBuilder
     [PublicAPI]
     ITestcontainersBuilder<TDockerContainer> WithHostname(string hostname);
 
+    /// <summary>
+    /// Sets the MAC address of the Testcontainer.
+    /// </summary>
+    /// <param name="macAddress">Testcontainers MAC address.</param>
+    /// <returns>A configured instance of <see cref="ITestcontainersBuilder{TDockerContainer}" />.</returns>
+    [PublicAPI]
+    ITestcontainersBuilder<TDockerContainer> WithMacAddress(string macAddress);
+
     /// <summary>
     /// Overrides the working directory of the Testcontainer for the instruction sets.
     /// </summary>

src/Testcontainers/Builders/TestcontainersBuilder.cs

@@ -112,6 +112,12 @@ public ITestcontainersBuilder<TDockerContainer> WithHostname(string hostname)
       return this.MergeNewConfiguration(new TestcontainersConfiguration(hostname: hostname));
     }
 
+    /// <inheritdoc cref="ITestcontainersBuilder{TDockerContainer}" />
+    public ITestcontainersBuilder<TDockerContainer> WithMacAddress(string macAddress)
+    {
+      return this.MergeNewConfiguration(new TestcontainersConfiguration(macAddress: macAddress));
+    }
+
     /// <inheritdoc cref="ITestcontainersBuilder{TDockerContainer}" />
     public ITestcontainersBuilder<TDockerContainer> WithWorkingDirectory(string workingDirectory)
     {
@@ -357,6 +363,7 @@ protected virtual ITestcontainersBuilder<TDockerContainer> MergeNewConfiguration
       var name = BuildConfiguration.Combine(dockerResourceConfiguration.Name, this.DockerResourceConfiguration.Name);
       var imagePullPolicy = BuildConfiguration.Combine(dockerResourceConfiguration.ImagePullPolicy, this.DockerResourceConfiguration.ImagePullPolicy);
       var hostname = BuildConfiguration.Combine(dockerResourceConfiguration.Hostname, this.DockerResourceConfiguration.Hostname);
+      var macAddress = BuildConfiguration.Combine(dockerResourceConfiguration.MacAddress, this.DockerResourceConfiguration.MacAddress);
       var workingDirectory = BuildConfiguration.Combine(dockerResourceConfiguration.WorkingDirectory, this.DockerResourceConfiguration.WorkingDirectory);
       var entrypoint = BuildConfiguration.Combine(dockerResourceConfiguration.Entrypoint, this.DockerResourceConfiguration.Entrypoint);
       var command = BuildConfiguration.Combine(dockerResourceConfiguration.Command, this.DockerResourceConfiguration.Command);
@@ -375,7 +382,7 @@ protected virtual ITestcontainersBuilder<TDockerContainer> MergeNewConfiguration
       var parameterModifiers = BuildConfiguration.Combine(dockerResourceConfiguration.ParameterModifiers, this.DockerResourceConfiguration.ParameterModifiers);
       var startupCallback = BuildConfiguration.Combine(dockerResourceConfiguration.StartupCallback, this.DockerResourceConfiguration.StartupCallback);
 
-      var updatedDockerResourceConfiguration = new TestcontainersConfiguration(dockerEndpointAuthConfig, dockerRegistryAuthConfig, image, imagePullPolicy, name, hostname, workingDirectory, entrypoint, command, environments, labels, exposedPorts, portBindings, mounts, networks, networkAliases, outputConsumer, waitStrategies, parameterModifiers, startupCallback, autoRemove, privileged);
+      var updatedDockerResourceConfiguration = new TestcontainersConfiguration(dockerEndpointAuthConfig, dockerRegistryAuthConfig, image, imagePullPolicy, name, hostname, macAddress, workingDirectory, entrypoint, command, environments, labels, exposedPorts, portBindings, mounts, networks, networkAliases, outputConsumer, waitStrategies, parameterModifiers, startupCallback, autoRemove, privileged);
       return new TestcontainersBuilder<TDockerContainer>(updatedDockerResourceConfiguration, this.mergeModuleConfiguration);
     }
 

src/Testcontainers/Clients/DockerContainerOperations.cs

@@ -188,6 +188,7 @@ public async Task<string> RunAsync(ITestcontainersConfiguration configuration, C
         Image = configuration.Image.FullName,
         Name = configuration.Name,
         Hostname = configuration.Hostname,
+        MacAddress = configuration.MacAddress,
         WorkingDir = configuration.WorkingDirectory,
         Entrypoint = converter.Entrypoint,
         Cmd = converter.Command,

src/Testcontainers/Configurations/Containers/ITestcontainersConfiguration.cs

@@ -49,6 +49,11 @@ public interface ITestcontainersConfiguration : IDockerResourceConfiguration
     /// </summary>
     string Hostname { get; }
 
+    /// <summary>
+    /// Gets the MAC address.
+    /// </summary>
+    string MacAddress { get; }
+
     /// <summary>
     /// Gets the working directory.
     /// </summary>

src/Testcontainers/Configurations/Containers/TestcontainersConfiguration.cs

@@ -32,6 +32,7 @@ public TestcontainersConfiguration(IDockerResourceConfiguration dockerResourceCo
     /// <param name="imagePullPolicy">The image pull policy.</param>
     /// <param name="name">The name.</param>
     /// <param name="hostname">The hostname.</param>
+    /// <param name="macAddress">The MAC address.</param>
     /// <param name="workingDirectory">The working directory.</param>
     /// <param name="entrypoint">The entrypoint.</param>
     /// <param name="command">The command.</param>
@@ -55,6 +56,7 @@ public TestcontainersConfiguration(
       Func<ImagesListResponse, bool> imagePullPolicy = null,
       string name = null,
       string hostname = null,
+      string macAddress = null,
       string workingDirectory = null,
       IEnumerable<string> entrypoint = null,
       IEnumerable<string> command = null,
@@ -80,6 +82,7 @@ public TestcontainersConfiguration(
       this.ImagePullPolicy = imagePullPolicy;
       this.Name = name;
       this.Hostname = hostname;
+      this.MacAddress = macAddress;
       this.WorkingDirectory = workingDirectory;
       this.Entrypoint = entrypoint;
       this.Command = command;
@@ -118,6 +121,9 @@ public TestcontainersConfiguration(
     /// <inheritdoc />
     public string Hostname { get; }
 
+    /// <inheritdoc />
+    public string MacAddress { get; }
+
     /// <inheritdoc />
     public string WorkingDirectory { get; }
 

tests/Testcontainers.Tests/Unit/Containers/Unix/TestcontainersContainerTest.cs

@@ -93,6 +93,26 @@ public async Task Hostname()
         }
       }
 
+      [Fact]
+      public async Task MacAddress()
+      {
+        // Given
+        const string macAddress = "92:95:5e:30:fe:6d";
+
+        // When
+        var testcontainersBuilder = new TestcontainersBuilder<TestcontainersContainer>()
+           .WithImage("alpine")
+           .WithMacAddress(macAddress)
+           .WithEntrypoint(KeepTestcontainersUpAndRunning.Command);
+
+        // Then
+        await using (ITestcontainersContainer testcontainer = testcontainersBuilder.Build())
+        {
+          await testcontainer.StartAsync();
+          Assert.Equal(macAddress, testcontainer.MacAddress);
+        }
+      }
+
       [Fact]
       public async Task WorkingDirectory()
       {