====== Docker ======
===== Grundlagen =====
Docker ist eine weitere Art der Virtualisierung von Applikationen.
Der Vorteil besteht darin das ein Docker-Container alle Abhängigkeiten integriert hat. Somit ist einfach möglich eine aktuelle Version von MySQL zu betreiben obwohl im Repo von der genutzten Distribution noch veraltete Versionen verfügbar sind.

Ebenso werden Ressourcen effizienter genutzt und die Dienste können auf einem Host isoliert voneinander betrieben werden.
Bei einer VM war das Betriebssystem immer vorhanden und der Aufwand bzw. die genutzten Ressourcen standen in keinem Verhältnis.

Ein Beispiel:
Ein einzelner DLNA Server (Bereitstellen von Medien über DLNA) kann sicherlich von vielen Medien-Servern miterledigt werden (Emby, Plex, Jellyfin....). dies erfordert jedoch enorme Ressourcen und manchmal will man nur diese kleine Sache zur Vefügung stellen.

Auf einem OS könnte sicherlich auch "minidlna" installiert werden was genau diesen einen Zweck erfüllt.

Möchte man nun jedoch diese Dienste voneinander trennen ist ein separater Server oder eine VM wie man Kanonen auf Spatzen schiessen.

Ein Docker-Container mit "minidlna" verbraucht sehr wenig Ressourcen und ist schnell aufgesetzt. Durch die Nutzung von Docker ist es hier auch möglich mal eben die Version zu wechseln, unabhängig von der Distribution.

===== Installation =====
Bitte immer nur die [[https://docs.docker.com/engine/install/|offizielle Installationsmethode von Docker]] verwenden:
  - Script herunterladen: <code bash>curl -fsSL https://get.docker.com -o install-docker.sh</code>
  - Inhalt überprüfen:<code bash>cat install-docker.sh</code>
  - Trockentest:<code bash>sh install-docker.sh --dry-run</code>
  - Script ausführen:<code bash>sudo sh install-docker.sh</code>
  - Docker starten:<code bash>sudo systemctl start docker.service</code>
  - Beim nächsten Systemstart starten:<code bash>sudo systemctl enable docker.service</code>
  - Den normalen Benutzer zur Docker Gruppe hinzufügen damit die Container auch im Benutzer-Context laufen können:<code bash>sudo adduser <Benutzername> docker</code>

Es ist ratsam einen Docker Ordner anzulegen, unter dem dann wieder für jeden Service ein Unterverzeichnis mit einer ''docker-compose.yml'' angelegt wird.
<code bash>
cd
mkdir -p ~/Projects/Docker
cd ~/Projects/Docker
</code>

Alternativ kann auch alles in ein "grosses" ''docker-compose.yml'' integriert werden.

===== Befehle =====
Hier eine kleine Übersicht der Befehle die am häufigsten genutzt werden

==== Allgemeines ====
<code>
# Laufende Container anzeigen lassen
docker ps
#
# Mit Shell in Container verbinden
docker exec -it <Container-Name> sh
#
# Logs vom Container anzeigen
docker logs -f <Container-Name>
#
# Docker-Stack starten
docker compose up -d
#
# Docker Container stoppen
docker stop <Container-Name> 
#
# Docker Container löschen
docker rm <Container-Name> 
#
# Generelles aufräumen
docker system prune -a -f
#
</code>

==== Netzwerk ====
<code>
# Netzwerke ansehen
sudo docker network ls
#
# Netzwerk erstellen
sudo docker network create <Netzwerk-Name>
#
</code>

==== Volumes ====
Die Volumes werden standardmäßig unter ''/var/lib/docker/volumes'' automatisch angelegt
<code>
# Volumes ansehen
sudo docker volume ls
#
# Volume erstellen
sudo docker volume create <Volume-Name>
#
</code>

===== Container für das Homelab =====
Auf den Beispielseiten sind die Container als docker-compose angegeben.
Gestartet werden sie jeweils 
<code bash>
sudo docker compose up -d
</code>

==== Beispiele ====

  * [[server:docker/gotify|Gotify - Eigener Benachrichtigungsmanager]]
  * [[server:docker/mariadb|MariaDB - RDBMS (relationale Datenbank)]]
  * [[server:docker/nginx-proxy-manager|Nginx-Proxy-Manager - Reverse Proxy]]
  * [[server:docker/paperless|Paperless-NGX - Einfaches DMS für zu Hause]]
  * [[server:docker/pihole|Pi-Hole - Werbeblocker für zu Hause]]
  * [[server:docker/unifi|UniFi - UniFi Controller Software]]
  * [[server:docker/vaultwarden|Vaultwarden - Passwortmanager der zu Bitwarden kompatibel ist]]
  * [[server:docker/whats-up-docker|Whats-Up-Docker - Überwachen der Versionen von Containern]]