ContainerManagement/Macvlan/README.md

# Macvlan

The installation has been done on a Synology DS720 but sould work on any System using [Portainer](https://www.portainer.io/)

## Why Macvlan?

Macvlan allows you to structure your container network according to your preferences.

## Prerequisites

- [Portainer](https://www.portainer.io/)

Further Prerequisites you can find on [docker docs](https://docs.docker.com/network/network-tutorial-macvlan/#prerequisites).

## Installation Guide

Open your local Environment on Portainer and choose "Networks"

### Network Configuration

First you need to add a Network Configuration. That will be used in your [Creation](#network-creation) later. It sets the rules and boundaries for how the network will operate and is reusable.

So click on "Add network" and name it. Then select macvlan as Driver and Configuration as Macvlan Configuration.

![Configuration Driverconfiguration - Example](images/Macvlan_Configuration_Driverconfiguration_example.png)

To find out your Parent network card you should connect to your system which is running Portainer with ssh and run

```
ifconfig
```

and hit Enter.

You should receive a list of elements. Search for your the ipaddress 

![Parent Network Card - Example](images/parentnetworkcard_example.png)

After that fill the IPV4 Network configurtion. For example:

![Configuration Networkconfiguration - Example](images/Macvlan_Configuration_Networkconfiguration_example.png)

Now select "Creat the network" and you can go on with the [Creation](#network-creation).

### Network Creation

Add a Network Configuration, select Creation and choose your Configuration.

![Creation Configuration - Example](images/Macvlan_Creation_Configuration_example.png)

Then select "Creat the network" and you're done.