===== Docker Nextcloud Image selbst bauen =====

Möchte man ein Nextcloud-Docker-Image anpassen oder selbst bauen, sind folgende Schritte notwendig.\\
Beispiel: Nextcloud 34.0.3 mit Apache-Image.

Ich benutze die Apache Version


===== Basis-Image =====

==== Basis-Image holen ====

<code>
# Quell‑Repo klonen
git clone https://github.com/nextcloud/docker.git
cd docker/34/apache

</code>

**Update daes Basisimages:**

in das Docker Directory wechseln und Image updaten mit:

<code>
git pull

</code>

2. prüfen, ob die gewünschte Version im Dockerfile vorhanden ist, in unserem Beispiel ENV NEXTCLOUD_VERSION 34.0.3


==== Dockerfile eventuell anpassen ====

3. Im Dockerfile kann man einige Variable anpassen, wenn man das möchte. Beispiel:

<code>
ENV PHP_MEMORY_LIMIT 2048M
ENV PHP_UPLOAD_LIMIT 2048M
ENV PHP_OPCACHE_MEMORY_CONSUMPTION 256
opcache.interned_strings_buffer=64

</code>

3.1. Besser ist es jedoch, ein eigenes volumne in docker-compose einzubinden. Beispiel

Beispielordnerstruktur:

<file>
projektordner/
├── docker-compose.yml
├── my-php/
│   └── 99-custom.ini   ← Hier liegt deine PHP-Konfig

</file>

Beispiel für eine 99-custom.ini

<file>
; --------------------------------------
; Benutzerdefinierte PHP-Einstellungen
; --------------------------------------

; Arbeitsspeicher
memory_limit = 2048M

; Upload-Limit für einzelne Dateien
upload_max_filesize = 2048M

; Maximalgröße von POST-Daten
post_max_size = 512M

; Maximale Skriptlaufzeit
max_execution_time = 300
max_input_time = 300

; Maximale Anzahl gleichzeitiger Datei-Uploads
max_file_uploads = 200

; Zeitzone (optional)
date.timezone = Europe/Vienna

</file>

Testbeispiel, ob die Werte auch wirklich geladen werden:

<code>
docker exec -it nextcloud php -i | grep memory_limit
docker exec -it nextcloud php -i | grep upload_max_filesize

</code>

So bindest du die Datei in docker-compose ein.
<file>

- ./my-php/99-custom.ini:/usr/local/etc/php/conf.d/99-custom.ini

</file>

==== docker-compose.yml anpassen und build starten ====

4. Ich lasse docker-compose.yml den build selbst machen. Dazu verändert man folgende Zeilen in docker-compose.yml in derm Abschnitt von Nextcloud Image

<code>
app:
  image: my-nextcloud:34.0.3-apache
  pull_policy: build

  build:
    context: /home/docker/docker-image/docker/34/apache
    dockerfile: Dockerfile
    pull: true
    no_cache: false

</code>

5. Build Prozess starten

- zuerst Syntax überprüfen

<code>
docker compose config

</code>

<code>
docker compose up -d

</code>

Ist ein lokales Image vorhanden, wird der build Prozess nicht gestartet. Das kann man erzwingen:

<code>
docker compose up -d --build

</code>

6. Abwarten, bis der build Prozess durchgelaufen ist, danach kann man die Version prüfen.


==== Mehrere Instanzen in einem Docker Daemon ====

Laufen alle Nextcloud Container am selben Docker daemon, reicht es völlig, **ein einziges Mal ein Tagged Image zu haben**. Jede ''docker‑compose.yml'' muss dann nur noch **dieses Tag als ''image:'' verwenden** – ohne ''build:'' ‑Block. Der Daemon liefert das Image aus seinem lokalen Cache; es wird **nichts neu gebaut und nichts gepullt**

Vorgangsweise:

1. zuerst prüfen, ob das Image überhaupt lokal vorhanden ist.

<code>
docker images | grep -i nextcloud

</code>

Wenn das Image nicht vorhanden ist, dann nochmals erzeugen
<code>

docker build --pull --no-cache -t my-nextcloud:34.0.3-apache /home/docker/docker-image/docker/34/apache

</code>

nochmals prüfen

<code>
docker run --rm --entrypoint grep my-nextcloud:34.0.3-apache OC_VersionString /usr/src/nextcloud/version.php

</code>

3. setze in alle docker-compose.yml folgende ein (ohnue build:)

<code>
image: my-nextcloud:34.0.3-apache

</code>

4. Container pro Nextcloud Instanz neu erzeugen

<code>
docker compose up -d --pull never --no-build --force-recreate

</code>


==== Tipp: Versionsvariable nur 1x pflegen: ====

1. Lege in jedem Instanz‑Verzeichnis (oder als Symlink auf eine gemeinsame Datei) eine **''.env'' ** an – Compose ersetzt Variablen automatisch
<code>
# .env
NEXTCLOUD_IMAGE=my-nextcloud:34.0.3-apache

</code>

2. In jedem docker-compose.yml im Nextcloud Abschnitt:

<code>
image: ${NEXTCLOUD_IMAGE}

</code>

3. Baue das neue Image **einmal**, ändere nur die Zeile in **einer** ''.env'', , wen du einen Symlink gesetzt hast, sonst in jeder, dann:
<code>
docker compose up -d # Container aller Instanzen werden ersetzt

</code>

4. gemeinsame .env erzeugen

<code>
echo 'NEXTCLOUD_IMAGE=my-nextcloud:34.0.3-apache'> /pfad/zur/datei.env

</code>

5. Symlink in jeder Instanz anlegen **(am beseten mit absolutem Pfad)**

<code>
ln -s /srv/nextcloud/common/.env .env

</code>

6. Docker-compose.yml nutzt die Variable

<code>
version: "3.9"
services:
  nextcloud:
    image: ${NEXTCLOUD_IMAGE}      # kommt aus der (verlinkten) .env
    # …

</code>


==== Docker Image auf neuen Server übertragen ====

1. Image nur einmal als Datei erzeugen

Vorher prüfen, ob Image vorhanden ist

<code>
docker images | grep -i nextcloud

</code>

dann
<code>

docker save my-nextcloud:34.0.3-apache | gzip -c> my-nextcloud_34.0.3-apache.tar.gz

</code>

2. **Datei auf den Ziel‑Host übertragen** (SCP, rsync, USB‑Stick …)
<code>

scp -P Portnummer my-nextcloud_34.0.3-apache.tar.gz user@host2:/tmp/

</code>

3. dort einspielen

<code>
gunzip -c /tmp/my-nextcloud_34.0.3-apache.tar.gz | docker load

</code>

4. Prüfen, ob das Image vorhanden ist
<code>

docker images my-nextcloud:34.0.3-apache

</code>

Jetzt taucht es lokal als ''my-nextcloud:34.0.1-apache'' auf – Compose kann’s direkt nutzen.

5 Docker-compose kann das File direkt nutzen

<code>
services:
  nextcloud:
    image: my-nextcloud:34.0.3-apache
    pull_policy: never    # verhindert versehentliche Pull‑Versuche

</code>

6. aufrufen mit

<code>
docker compose up -d      # reicht vollkommen, kein Pull nötig

</code>

Falls du ganz sicher gehen willst:

<code>
docker compose up -d --pull never --no-build

</code>


==== Redis (oder einzelne Services) updaten – pro Compose-Instanz ====

Im jeweiligen Compose-Projektordner (dort wo du ''docker-compose.yml'' /Symlink aufrufst):
<code>
docker compose pull redis
docker compose up -d --no-deps redis

</code>

  * ''pull redis''  lädt das neue Image (falls Tag/Digest neuer ist)
  * ''up -d –no-deps redis''  erstellt **nur Redis**  neu, ohne alles andere neu zu starten Wenn du mehrere Services updaten willst:
<code>
docker compose pull redis mariadb
docker compose up -d --no-deps redis mariadb

</code>