version: '2'
services:
  nextcloud:
    image: nextcloud:latest
    container_name: cloudcity
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
    volumes:
      - /var/www/html 
    depends_on:
      - nextclouddb
    restart: unless-stopped
  nextclouddb:
    image: yobasystems/alpine-mariadb:latest
    container_name: cloudcitydb
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=changeme
      - MYSQL_PASSWORD=changeme
      - MYSQL_DATABASE=changeme
      - MYSQL_USER=changeme
    volumes:
      - /var/lib/mysql
    restart: unless-stopped

Een Docker Compose File kan je dan gebruiken in Portainer (Portainer = grafische schil om je Docker omgeving ) wat zorgt dat je meerdere services zoals in dit voorbeeld:

1. Wordpress
2. Database (voor Wordpress)

In 1 keer kan uitrollen i.p.v. dat je elke Service apart installeert. Heel handig maar heel erg foutgevoelig (YAML)

version: '2'

services:

  wordpress:
    image: wordpress
    restart: always
    ports:
      - 8080:80
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: exampleuser
      WORDPRESS_DB_PASSWORD: examplepass
      WORDPRESS_DB_NAME: exampledb
    volumes:
      - wordpress:/var/www/html

  db:
    image: yobasystems/alpine-mariadb:latest
    restart: always
    environment:
      MYSQL_DATABASE: exampledb
      MYSQL_USER: exampleuser
      MYSQL_PASSWORD: examplepass
      MYSQL_ROOT_PASSWORD: changeme
    volumes:
      - db:/var/lib/mysql

volumes:
  wordpress:
  db:

Uiteraard moet je USER en PASSWORD wel wijzigen :)

NOTE:

Het netwerk waarin Wordpress zich installeert moet je misschien aanpassen meestal wordt het netwerk zo iets als <stackname_default>. Ik heb hier dagen over zitten pielen en heb nog niet DE setting gevonden maar het werkt voor nu :)

Voor de installatie van Docker & Portainer heb ik de volgende commando's gebruikt op de Raspberry Pi5

note: het commando sudo i.c.m. je wachtwoord is benodigd om voldoende rechten te hebben om deze commando's uit te voeren. Dit kan per omgeving en set-up verschillen.

1.Docker Download: sudo curl -sSL https://get.docker.com | sh
2.Het toevoegen van een gebruiker aan Docker: sudo user to docker group: sudo usermod -aG docker <USERNAME>, ik heb gekozen voor de username die ik ook gebruik voor in te loggen op mijn Raspberry Pi.

3. Check of Docker actief is d.m.v. commando: docker, dit zal het volgende resultaat geven als docker actief is:

Usage: docker COMMAND
etc.

Om Docker en de containers makkelijker te beheren in een grafische omgeving maak ik gebruik van Portainer - https://www.portainer.io/

Portainer Container Download: sudo docker pull portainer/portainer-ce:linux-arm
Portainer Container Installatie: sudo docker run -d -p 9000:9000 -p 8000:8000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer:latest

In dit commando is op genomen dat Portainer altijd herstart en bereikbaar is via poort: 9000

Start je browser op en tik in: http://IP ADRES (PI5) of HOSTNAME.LOCAL:9000

In mijn geval is het: http://naam Pi5.local:9000

Als het goed is moet dit scherm verschijnen:

De inrichting van Docker & Portainer zal in een separaat topic behandeld worden.

Ook voor de dit Cook HOW TO Book geldt mochten er zaken niet kloppen of onduidelijk zijn laat het weten ❤️ 

• 1. Raspberry Pi5
• 2. SDcard min. 4GB
• 3. SSD Disk

STAP 1:

1. Download Raspberry Pi Imager - https://www.raspberrypi.com/software/. Dit doe je op je PC - Windows
2. Installeer de Raspberry Pi Imager sofware
3. Stop de SDcard in je PC bijv. via een SDcard reader o.i.d. De SDCard zal al een extra device/drive verschijnen in je Windows Verkenner

Start Raspberry Pi Imager software

1. Kies Raspberry Pi Model: Raspberry Pi5
2. Kies Besturingssysteem: Misc. Utilities -> Bootloader (Pi 5 Family) -> NVME/USB Boot
3. Opslagapparaat: Selecteer de USB Drive

Klik Volgende

Bij de melding "Alle bestaande gegevens worden op <USB DRIVE> zullen worden verwijdert" - "Weet u zeker dat u door wilt gaan?" - klik JA

Als de installatie is afgerond moet je de volgende melding krijgen:

Haal de SDCard uit je PC en stop deze in de SDCard slot van je Pi5

Start de Raspberry Pi5 op. De Ledlampje op de Pi zal gaan knipperen (GROEN). Als je de PI aangesloten hebt op een monitor zal het beeld na verloop van tijd een GROEN scherm geven. Dit houdt in dat de installatie gelukt is en de Pi kan booten van USB

STAP 2:

1. Sluit de SSD disk aan op je PC

Start de Raspberry Pi Imager op

1. Kies Raspberry Pi Model: Raspberry Pi5
2. Kies Besturingssysteem: Kies hier het gewenste OS - ik heb zelf gekozen voor Ubuntu Server 24.04 LTS
3. Opslagapparaat: Selecteer SSD Disk

Klik Volgende en hier zal gevraagd worden of je de installatie van je OS wilt voorzien van je eigen settings. Indien je gewenst is kies je AANPASSEN zoniet kies je NEE.

TIP : Als je de instellingen aanpast kan je gelijk SSH aanzetten.

Nu zal het OS gedownload worden en op de SSD worden geïnstalleerd.

Als de installatie gereed is zal dit scherm verschijnen waarbij je de SDcard uit de Pi5 kan halen.

Sluit de SSD Disk aan op de Pi en start de Pi op. Nu zal het OS starten vanaf de SSD Disk zoals hier onderstaand.

Nu het OS geïnstalleerd en op gestart is kan je verder bouwen aan je omgeving.

Mocht er in deze HOW TO fouten staan e.d. hoor ik dat graag ook alle vragen/opmerkingen zijn van ❤️ te welkom.

Bron: https://forum.yunohost.org/t/install-yunohost-on-raspberry-pi-4b-on-ssd/25090

1. Burn a MicroSD card with the current Yunohost image as in the documentation.
2. Boot the Pi from the SD card, connect, and let it run through the installation process so you have an admin login.
3. Connect to the Pi over SSH with the admin user.
4. Check the status of the Pi EEPROM with sudo vcgencmd bootloader_version. The version date is on the first line and should be later than 2020/03/09.
5. Check for an update with sudo rpi-eeprom-update. There may be an update available, but the update channel needs to be changed from default (that was in my case, the blog entry says it will be critical) to stable.
6. Open /etc/default/rpi-eeprom-update with an editor. For ease of use sudo nano /etc/default/rpi-eeprom-update. You will see the line FIRMWARE_RELEASE_STATUS="default". Change default to stable. Save the file.
7. Check sudo rpi-eeprom-update again. This should show an update.
8. Apply the update with sudo rpi-eeprom-update -a, and reboot.
9. When the Pi has rebooted, check that the update has been applied with vcgencmd bootloader_version again.
10. Now change the boot order. This can be done through raspi-config.
11. Run sudo raspi-config and select 6. Advanced Options.
12. Select A6 Boot Order. Confirm that the first option is B1 SD Card Boot Boot from SD Card if available, otherwise boot from USB. If it isn’t, make an option that includes USB first - the second option for me is B2 USB Boot Boot from USB if available, otherwise boot from SD Card, but I can’t change to that in the Yunohost image.
13. Next, burn the Yunohost image to your SSD. This works in the same way as an SD card, so use Etcher or the image burner of your choice. Etcher will tell you that your SSD is a large device and ask for confirmation.
14. You now have a 2.1GB image on your SSD so it needs to be resized. On a Linux based desktop this will need Gparted or another disk management tool (Gnome Disks, KDE Partition Manager etc) so start that.
15. The external SSD should appear with your local storage with a FAT32 boot partition, a 2.1 GB rootfs partition and a lot of unallocated space. Resize the rootfs partition to use up as much space as it can. Gparted, Disks and KDE Partition Manager will do this graphically.
16. Remove the SD card from the Pi and plug the SSD into one of the USB 3 ports and boot.
17. Connect to the Pi with a web browser - it should have the same IP as with the SD card if your router is working correctly and run the configuration again. You should then have a clean Yunohost install on the SSD.

Download links:

Balena Etcher: https://etcher.balena.io/#download-etcher

Yunohost: https://yunohost.org/en/install/hardware:rpi34

UPDATE: Nieuwe Cookbook volgt a.s.a.p. 🤣 

So it looks like something between Linux v5.10 and v5.15 changed which affects QNAP NFS mounts in particular: https://dietpi.com/phpbb/viewtopic.php?t=10238
So another test with current kernel, to verify that both issues are the same, would be add nfsvers=4 as mount option.
(See https://github.com/MichaIng/DietPi/issues/5358 )

Dus, de diverse shares handmatig toevoegen (met een mkdir voor de folders) in plaats van een nfs link naar de server die de shares als subdir toevoegt, en voor elk de nfs versie aangeven.

Handmatige wijziging in /etc/fstab:

#----------------------------------------------------------------
# NETWORK
#----------------------------------------------------------------
# qnas.home:/ /mnt/nfs_qnas nfs nofail,noauto,x-systemd.automount
qnas.home:/dietpi-systeem /mnt/nfs_qnas/dietpi-systeem nfs nofail,noauto,x-systemd.automount,nfsvers=4
qnas.home:/dietpi-data /mnt/nfs_qnas/dietpi-data nfs nofail,noauto,x-systemd.automount,nfsvers=4

Daarna mounts herladen door het verversen van systemd’s ‘view of the world’, inclusief de wijzigingen in /etc/fstab, door het commando

systemctl daemon-reload

LetsEncrypt maakt gebruik van Certbot om het certificaat aan te vragen of te vernieuwen. Dit kan ook handmatig via sudo certbot renew 

In het proces wordt gebruik gemaakt van Lighttpd als bestaande webserver, waarbij Certbot een token bestand aanmaakt in /var/www/.well-known/acme-challenge/ en deze vervolgens opvraagt over http via http://<website_domain_FQN>/.well-known/acme-challenge/<token_bestand> 

Het blijkt dat bij gebruik van Lighttpd Certbot de folders en het token bestand aanmaken als gebruiker/groep root, terwijl Lighttpd alleen bestanden aan kan bieden aan webclients die www-data als gebruiker/groep hebben. Het resultaat is dat de http-01 challenge mislukt door een time-out omdat het torenbestand niet opgehaald kan worden.

Een oplossing of workaround hiervoor blijkt te zijn om de ingebouwde webserver van Certbot te gebruiken. Deze moet verbinding maken met de porten die door Lighttpd in gebruik zijn, en daarvoor moet die service eerst afgesloten worden en na de verversing weer worden opgestart. Dit kan op twee wijzen, via de command line en via de config bestanden van Certbot. Hierbij past Certbot de opties van het directe commando aan in het config bestand voor toekomstig gebruik - maar dit betekent waarschijnlijk ook dat bij andere invoer het config bestand niet meer werkt zoals gewenst.

Het directe commando om te gebruiken is:

sudo certbot renew --pre-hook "service lighttpd stop" --post-hook "service lighttpd start" --standalone

Het configuratiebestand voor renewal opdrachten staat op:

/etc/letsencrypt/renewal/<FQN_domain_Name>.conf

Deze ziet er dan zo uit (let op dat de omleiding naar de folder van de website bij het domain niet actief is door # aan het begin van de regel!):

# renew_before_expiry = 30 days
version = 1.12.0
archive_dir = /etc/letsencrypt/archive/<FQN_domain_name>
cert = /etc/letsencrypt/live/<FQN_domain_name>/cert.pem
privkey = /etc/letsencrypt/live/<FQN_domain_name>/privkey.pem
chain = /etc/letsencrypt/live/<FQN_domain_name>/chain.pem
fullchain = /etc/letsencrypt/live/<FQN_domain_name>/fullchain.pem

# Options used in the renewal process

account = <account_token>
rsa_key_size = 4096
authenticator = standalone
webroot_path = /var/www,
server = https://acme-v02.api.letsencrypt.org/directory
pre_hook = service lighttpd stop
post_hook = service lighttpd start

[]
#<FQN_domain_name> = /var/www/<sub-folder>

Met deze config file zou een toekomstige automatische renewal ook moeten werken. 

Gebruik https://crt.sh om te kijken of er nieuwe certificaten aan je domein zijn gekoppeld.

Doel: Raspberry Pi met een Nextcloud server

Plan:

1. Besturingssysteem: Diet-Pi
2. SSD voor opslag met zo mijn mogelijk belasting van de SD kaart
3. Nextcloud als applicatie op de Pi met 
   1. Lighttpd als http server
   2. LetsEncrypt voor https connecties ; http verbindingen niet toestaan
   3. Data en Nextcloud configuratie bewaren op een wijze die eenvoudig te backuppen is.
   4. Gebruikerstoegang beveiligen met 2FA en/of autorisatie via derden
   5. Participeren in federatie
   6. Veilige en snelle toegang zowel lokaal als van internet
4. Lokale Back-up naar NAS in lokaal netwerk
5. Restore programma (kookboek voor snelle herbouw Pi en indien nodige, restauratie van de data die op de NAS is gebackup’d

Omgevingsfactoren om rekening mee te houden:

• Internet router wordt gebruikt voor DHCP, lokale DNS en port-forwarding
• QNAP NAS kan opgeslagen data veilig versleuteld extern opslaan voor een geografisch verspreidde back-up. Dus de Pi hoeft alleen een backup naar deze NAS af te handelen
• Gebruikersgegevens worden lokaal aangemaakt. Gebruikersbeheer via LDAP, bijvoorbeeld op de QNAP, behoort tot de mogelijkheden

Stap 1 - Installeer het basissysteem

Installatie instructies zijn beschreven op https://dietpi.com/docs/install/ 

Op deze site kun je de juiste image voor je systeem downloaden en met bijvoorbeeld balenaEtcher flashes naar SD kaart of SSD. Voor dit project doen we het laatste. Merk op dat diet-pi standaard SSH ondersteuning biedt met de hostname dietpi. Standaard login is root met wachtwoord dietpi (het standaard wachtwoord kun je wijzigen in dietpi.txt) Tijdens de eerste login moet je dit wachtwoord gelijk wijzigen.

Overweeg om meerdere (logische) schijven te gebruiken voor het scheiden van besturingssysteem en gebruikersdata. Diet-Pi maakt gebruik van de locatie /mnt/dietpi_userdata/ voor de opslag van gebruikersdata, die zowel naar een directory op dezelfde schijf als naar een andere partitie (op een andere schijf) kan verwijzen. We kiezen hier voor een aparte data partitie en omdat onze SSD lekker groot is zijn we niet te zuinig met de systeempartitie. We gebruiken DiskGenius op een Windows PC om twee ext4 partities aan te maken, een van 100G voor het systeem, en de rest voor de data. Dit doen we nadat Balena Etcher de image van het dietpi systeem erop heeft gezet. We vergroten de systeempartitie en voegen de data partitie inn het vrijblijvende deel toe als nieuwe partitie. Gemak dient de mens bij het beheer van je systeem, een dit staat toe dat je een reinstall kan uitvoeren van het systeem zonder de dataschijf te beschadigen (merk op…. BalenaEtcher zal de datapartitie verwijderen als je een image terugzet).t Het organiseren van een goede back-up van de userdata directory/partitie blijft belangrijk! 

Stap 2 - Gebruik een SSD in plaats van een SD card

Wanneer het starten van SSD niet lukt, volg dan de stappen als beschreven in “Basissysteem Diet-Pi installeren op een SSD”

Stap 3 - Configureer dietpi

Start na de installatie van dietpi het systeem op gebruik een ssh sessie met root als gebruikersnaam en dietpi als wachtwoord om de configuratie af te ronden. Volg de instructies en wijzig het Global Software password en het console password voor dietpi/root. Log vervolgens altijd in met gebruiker dietpi op de console en gebruik su of sudo om root rechten te krijgen wanneer noodzakelijk. Laat het systeem niet aanstaan zolang het standaard wachtwoord niet veranderd is!

Gebruik het commando dietpi-config en kies optie 6) security options om de houtnaam te wijzigen van dietpi naar een naam van je voorkeur.

Vervolgens is het tijd om /mnt/dietpi-userdata te koppelen aan de data partitie. Gebruik het commando sudo dietpi-drive_manager of kies voor de zekerheid root access met su root om problemen met rechten te voorkomen. Je kunt er nu voor kiezen de partitie te munten. De partitie is gelinkt aan een unieke identity voor de schijf. Laat dit serienummer ook het mountpunt zijn, dus de schijf wordt benaderbaar op /mnt/

Na het mounten van de schijf heb je de keuze om User Data en Swap File naar deze schijf over te zetten. Kies in ons geval voor alleen userdata, die nu beschikbaar komt op /mnt//dietpi-userdata. Alle data blijft beschikbaar via /mnt/dietpi-userdata die nu een hardlink naar /mnt//dietpi-userdata heeft, zoals eenvoudig te controleren is met een ls -l /mnt.

We zijn nu klaar om de gewenste software te installeren.

Stap 4 - Installeer Nextcloud

Voorlopig houden we de dietpi alleen nog beschikbaar op het lokale LAN, dit geeft ons de gelegenheid Nextcloud te installeren met een basisbeveiliging voordat we de boel openzetten naar internet.

Zorg dat je ingelogd bent onze account dietpi en gebruik het sudo dietpi-software commando om software te installeren.

In het menu kun je zien dat http al standaard geïnstalleerd is. Dit kun je wijzigen naar een Apache of NGINX webserver. Wij willen httpd.

Kies Browse Software en selecteer Nextcloud (software package 114), en Install. Bevestig de keuze om de installatie te starten.

Zie verder: https://dietpi.com/docs/software/cloud/#nextcloud

Krijg toegang tot de web interface via de volgende URL: 

• Via de Pi SBC: http://localhost/nextcloud/, of (in ons geval)
• Het IP adres / hostname van de DietPi (bijv.: http://192.168.0.100/nextcloud/)

Initiële gebruikuikersgegevens zijn:

• Username = admin
• Password =

Onder Apps/Security, installeer Two Factor Authentication. Creëer ook een nieuwe gebruiker die als admin gebruikt kan worden. Schakel 2-factor authenticatie voor dit account in en gebruik deze voortaan om Nextcloud te beheren. Schakel daarna het account admin uit.

Maak een gebruikersaccount aan die niet in de admin groep zit voor het dagelijkse gebruik. Gebruik ook hiervoor 2-factor authenticatie.

Installeer ook de app Brute-force IP whitelist. 

De Nextcloud server is nu in de basis beschermd tegen misbruik en we kunnen hem toegankelijk maken via internet om SSL certificaten in te stellen.

Stap 5 - LetsEncrypt SSL certificaat installeren voor ondersteuning https verbindingen

Eerst moeten http (port 80) en https (port 443) doorverwezen worden naar de Pi server. De methode is afhankelijk van je DSL/glasvezel router. Je kunt er ook voor kiezen om IPv6 door te sturen. Zorg dat je de DNS instellingen van je domeinnaam kunt bewerken.

Gebruik het sudo dietpi-software commando om CertBot te installeren

Na installatie kan de configuratie starten met sudo dietpi-letsencrypt. Vul de benodigde gegevens in en selecteer de redirect on optie om http verkeer altijd om te leiden naar https. Mochten er problemen zijn met de automatische vernieuwing van het certificaat, dan Kann het commando certbot renew uitkomst bieden. Zie deze post voor een mogelijke oplossing bij problemen.

Stap 6 - configureer webserver en redirect de hostname voor Nextcloud naar de Nextcloud website.

De Raspberry beschikt over een mooie quadcore CPU, dus we kunnen multithreading aanzetten. Ook willen we de hostname van onze site cloud.domein.tl doorverwijzen naar de Nextcloud website. In de toekomst willen we eventueel een tweede website naar een andere folder structuur verwijzen, bijvoorbeeld city.domein.tl naar Owncloud. 

Pas daartoe de configuratie aan van lighttpd. Ga naar de configuratie directory met cd /etc/lighttpd/

En bewerk het bestand lighttpd.conf met je favoriete teksteditor (vi uiteraard, installeer de teksteditor wanneer deze niet beschikbaar is via dietpi-software). Voeg aan dit bestand de volgende text toe, aangepast voor jouw domeinnaam voor nextcloud (merk op, de sectie voor owncloud is een voorbeeld voor het toevoegen van een tweede website):

#Set multithreading to 4 processors
server.max-worker = 4
#
# Add document root for cloud.domein.tl to nextcloud
#
$HTTP == "cloud.domein.tl" {
  server.document-root = "/var/www/nextcloud/" 
}
# Add document root for city.domein.tl to owncloud
#
$HTTP == "city.domein.tl" {
  server.document-root = "/var/www/owncloud/" 
}

De nextcloud omgeving is nu het best te benaderen door gebruik te maken van de internet hostnaam. Wanneer de lokale naam van de server gebruikt wordt loop je de kans op een foutmelding omdat het SSL certificaat van LetsEncrypt niet overeenkomt met de lokale naam.

Nu de basis draait kan de aandacht naar verdere stappen: back-up en NextCloud configuratie. 

Stap 7 - NAS Shares koppelen over NFS

We willen back-ups maken naar de QNAP NAS en maken hierbij gebruik van NFS omdat dit het beste werkt in een Linux omgeving. Denk hierbij aan gebruikersrechten die je via rsync wilt behouden.

We maken een nieuwe share aan met de naam dietpi_systeem en een share met de naam dietpi_data. Voor beide shares geven we alleen administrators lees en schrijfrechten, toegang tot de Microsoft Networking-host laten we leeg, en toegang tot de NFS-host is met sync no wdelay, secure, en alleen voor de dietpi hostnaan of IP adres waarmee hij op het lokale LAN bekend is. 

• Host/IP/Netwerk: dietpi.home of het vaste interne IP adres van deze server.
• Squash-optie: Lezen/schrijven
• De overige opties houden we standaard.

Merk op dat hiermee toegang wordt verleend aan een apparaat op het netwerk, en niet aan een gebruiker.

Wanneer de shares aangemaakt zijn gaan we ze koppelen in DietPi. Dit doen we met

sudo DietPi-Drive_Manager

Of we openen de drive manager vanuit DietPi-Launcher

Kies Add network drive, en dan NFS

Type de hostname of het IP adres van de NAS zoals deze op het LAN bekend is, bijv. qnap.home, en selecteer <OK>. Kies een naam voor de folder onder /mnt waarop de NFS server gekoppeld wordt. Bijvoorbeeld nfs_qnap en loop door de stappen om dit proces af te sluiten.

Je ziet nu in de lijst met verbindingen /mnt/nfs_qnap verbonden met qnap.home  

De onderliggende shares dietpi_systeem en dietpi_data zijn beschikbaar als directories onder /mnt/nfs_qnap en wanneer de deze een keer gebruikt worden komen ze ook te voorschijn in Drive_Manager.

We hebben nu twee locaties om data naar te back-uppen, bijvoorbeeld via rsync.

Stap 8 - Back-ups maken

We willen een back-up maken van de Nextcloud SQL database, en van de gebruikersdata. We doen dit s’nachts als iedereen slaapt, dus laten even de noodzaak om de service te stoppen buiten beschouwing. We maken gebruik van de dietpi configuratie om ons leven makkelijk te maken.

Voor de gebruikersdata maken we gebruik van rsync om de nextcloud_data directory naar de dietpi_data share te kopiëren. Aangezien we de belangrijke data van de NAS extern archiveren, kunnen we met het rsync commando verwijderde bestanden synchroniseren.

Hiertoe starten we de configuratie met sudo dietpi-sync. Als data geven we op:
Source: /mnt/<USB-schijf-ID>/dietpi_userdata/nextcloud_data 
Destination: /mnt/nfs_qnap/dietpi_data/dietpi_userdata/nextcloud_data

Merk op dat de appdata_<nextcloud-code> enorm veel bestanden bevat en zeker bij de eerste sync veel tijd zal vragen. Daaropvolgend rsyncs zijn incremental, en geven dus alleen wijzigingen door waarmee de opdracht aanzienlijk sneller is afgerond.

Hetzelfde geld voor de systeem-backup. De eerste keer dat een back-up gemaakt wordt kan het ‘enige tijd’ in beslag nemen omdat er heel veel kleine bestanden worden overgezet. Daaropvolgende backups op basis van rsync gaan makkelijker.

Start de back-up configuratie met sudo dietpi-backup en geef de locatie voor de backup, in ons voorbeeld /mnt/nfs_qnap/dietpi_systeem/sysbak/ - we willen de backup in een folder op de NAS share hebben om de systeem back-up te onderscheiden van de backup van de MariaDB.

In filter vervangen we de + voor /mnt/dietpi_userdata door een -. We hebben immers al een rsync voor deze folder. Zet Amount op om het bij 1 back-up te houden. Meerdere versies kan, maar heeft mogelijk tot gevolg dat een back-up langer duurt. Draai twee keer een backup handmatig, en kijk of het werkt en of de tweede backup sneller voltooit. Zet bij succes de Daily Back-up op .

Om een dagelijkse back-up te maken van de Nextcloud MySQL/MariaDB database, maken we tot slot een bestand genaamd backup-mysql-cronjob aan in de map /etc/cron.daily/ met de volgende inhoud (eindig het bestand met een enter om de regel af te sluiten!):

#!/bin/bash
sudo -u www-data php /var/www/nextcloud/occ maintenance:mode --on
mysqldump --single-transaction nextcloud > /mnt/nfs_qnap/dietpi_systeem/sqlbak/nextcloud-sqlbak_`date +"%Y%m%d"`.bak
sudo -u www-data php /var/www/nextcloud/occ maintenance:mode --off

Dit script zet achtereenvolgens de maintenance mode van Nextcloud aan (nu wel!), maakt een back-up van de SQL database (opdracht is geldig voor MySQL of Mariadb) naar een bestand op datum, en zet daarna de maintenance mode weer uit. Let erop dat je eens in de zoveel tijd oude bestanden verwijderd. Dit kan eventueel ook met een script, waarover later misschien meer.

Stap hopelijk nooit: Restore

Bij problemen kun je de volgende site gebruiken om de Nextcloud installatie terug te zetten vanuit de back-up: https://docs.nextcloud.com/server/23/admin_manual/maintenance/restore.html

Aangezien de data na te lopen is op de NAS geloven we wel dat deze beschrijving gaat werken en nemen het risico op iets meer handmatige restoratie werkzaamheden voor lief :)

Het leuke aan een Docker container is dat deze een complete installatie vormt. Een container wordt eenmaal gebouwd en kan dan gedistribueerd worden over meerdere hosts. Voor vele services bestaat er een originele Docker container die via het internet automatisch kan worden gelanceerd. Bij het eerste gebruik wordt de laatste (of een specifieke) versie gedownload, waarna telkens de lokale versie zal worden gebruikt tot er een nieuwere is.

Om Docker te kunnen gebruiken zal deze als service (dokkerd) op de host moeten worden geïnstalleerd. Daarna kunnen containers beheerd worden via diverse Docker commando’s. Dit Proces kan worden vereenvoudigd door gebruik te maken van Docker-Compose. Dit is een additionele applicatie die werkt met .yml bestanden. In de bestanden worden de parameters opgenomen die je normaal gesproken op de commandline opgeeft.

Om het beheer van de containers nog makkelijker te maken is Portainer ontwikkeld. Portainer biedt een web interface om Docker containers te beheren, en kan zelf als microservice in een container draaien. Wanneer de basis Docker/docker-compose/portainer draait heb je een goede basis om de Docker omgeving te beheren, containers toe te voegen, weg te halen, te starten en te stoppen. Let er daarbij op dat Docker containers standaard voor het x86 platform gemaakt worden en gebaseerd zijn op Linux. Voor andere processorarchitecturen als ARM voor de Raspberry Pi moet je dus een Docker container kiezen die voor een ARM gebouwd is.

Data persistentie met Docker Volumes

Ah, allemaal leuk en aardig dat alles in een Docker container staat. Maar als je je container herinstalleert of vervangt voor een nieuwe ben je je configuratie en opgeslagen data kwijt. Daar gaat je in een container gehoste website! Maar daar is natuurlijk een oplossing voor gevonden. En daar speelt de Linux/Unix omgeving nu een belangrijke rol. 

Hoe werkt schijfgebruik onder een Unix omgeving? Iedere (partitie op) een harde schijf wordt een in de Unix wereld een volume genoemd. En om een volume te gebruiken in je opslag dien je dit te mounten in je folder structuur. Deze structuur begint bij de wortel (de root, aangegeven met / ). Bij een mount verbindt je een volume aan een mapnaam. Iedere container heeft zijn gescheiden en besloten opslagomgeving (dus zijn eigen / ). Docker staat het toe om een map op de host als een volume te koppelen aan de container. De map op de host en al zijn subdirectories komen dan te staan onder het punt dat je opgeeft. OP die manier kun je dus data ‘in de container’ opslaan en gebruiken die zich buiten de container bevindt en blijft bestaan wanneer de container verwijderd wordt. Door slim mappen te koppelen waar configuratie of data wordt opgeslagen kun je deze dus persistent maken. Welke mappen je koppelt is dan afhankelijk van de service.

Belangrijke Variabelen

Bij de configuratie zijn onder andere de volgende variabelen dan ook belangrijk om mee te geven:

• Containernaam
• Dockercontainer en versie
• ‘Port forwarding’ host:container
• Volumes:mountpunt

Meer informatie is te vinden bij de volgende tutorial handbooks (zeker lezen wanneer je met Docker aan de slag wilt gaan):

• https://blog.ssdnodes.com/blog/what-is-self-hosting/ (en we doen dit lekker wel op een lokale server… anders is het gen ‘self’hosting, toch? Dan noemen we dat gewoon hosting!)
• https://blog.ssdnodes.com/blog/self-hosting-handbook/
• https://blog.ssdnodes.com/blog/self-hosting-handbook/
• https://blog.ssdnodes.com/blog/getting-started-docker-vps/