# [Anleitung] Externes Docker-Netzwerk (Bridge/Macvlan) in Portainer & CLI einrichten

Hallo zusammen,

damit Container wie Nextcloud, Paperless, Immich oder Vaultwarden stabil untereinander kommunizieren können oder – wie in unseren vorherigen Anleitungen – feste IPs aus eurem Heimnetzwerk bzw. VPS-Subnetz zugewiesen bekommen, benötigt Docker ein sauber konfiguriertes Netzwerk.

Standardmäßig isoliert Docker jeden Stack. Wenn ein Container aber eine feste IP bekommen soll, müssen wir das Netzwerk einmalig als "externes" Netzwerk im System anlegen.

Hier ist die Anleitung, wie ihr ein solches Netzwerk entweder direkt über die Konsole (CLI) oder ganz bequem über die Portainer-Weboberfläche einrichtet.

---

### Methode 1: Einrichtung über die Linux-Konsole (CLI)

Verbindet euch per Putty mit eurem Docker-Server und führt je nach gewünschtem Netzwerktyp einen der folgenden Befehle aus.

#### Variante A: Das Standard-Bridge-Netzwerk (Empfohlen für VPS im Rechenzentrum)
Hierbei teilt sich Docker einen internen IP-Bereich auf dem Server. Die Container sind untereinander erreichbar und werden über den Nginx Proxy Manager nach außen freigegeben.

bash

docker network create

--driver=bridge

--subnet=192.168.164.0/24

--gateway=192.168.164.1

Netzwerk-Container



#### Variante B: Das Macvlan-Netzwerk (Empfohlen für Heimnetzwerke / Proxmox LXC)
Hierbei bekommt jeder Container eine eigene, echte IP-Adresse direkt aus eurem Heimnetzwerk (z. B. von eurer FRITZ!Box) und verhält sich wie ein eigenständiges Gerät im LAN.

*Wichtig: Ersetzt eth0 durch den echten Namen eurer Netzwerkkarte (herauszufinden über den Befehl ip a).*

bash

docker network create

-d macvlan

--subnet=192.168.178.0/24

--gateway=192.168.178.1

--ip-range=192.168.178.64/26

-o parent=eth0

Netzwerk-Container



---

### Methode 2: Einrichtung über die Portainer Weboberfläche

Wer lieber klickt, kann das Netzwerk in unter einer Minute in Portainer anlegen:

1. Loggt euch in euer **Portainer-Dashboard** ein.
2. Klicke im linken Menü auf **Networks** und oben rechts auf den Button **+ Add network**.
3. Tragt folgende Daten in die Maske ein:
* **Name:** Netzwerk-Container
* **Driver:** bridge (oder macvlan, wenn die Container echte LAN-IPs erhalten sollen)
4. Scrolle nach unten zum Bereich **IPv4 Network Configuration**:
* **Subnet:** 192.168.164.0/24 (bzw. euren Netzwerkbereich)
* **Gateway:** 192.168.164.1
5. Klicke ganz unten auf den blauen Button **Actions** ➡️ **Create the network**.

---

### 💡 Wie binde ich dieses Netzwerk nun in meinen Stacks ein?

Damit ein Docker Compose Stack dieses eben erstellte Netzwerk verwenden darf, muss es am Ende der docker-compose.yml unter dem Punkt networks als **external** deklariert werden.

Hier ist das Minimalbeispiel, wie das im Code eurer Stacks aussehen muss:

yaml

version: '3.8'



services:

mein-app-container:

image: nginx:alpine

container_name: test-app

networks:

Netzwerk-Container:

ipv4_address: 192.168.164.150 # <--- Hier weist ihr dem Container seine feste Wunsch-IP zu!



networks:

# Hier sagen wir Docker, dass das Netzwerk existiert und nicht neu erstellt werden soll

Netzwerk-Container:

external: true