#1: Betriebssystem vorbereiten

Owned by fraggle_DE
Last updated: 20.Oct 2023

Windows 10:

Programme installieren (DE)

Unter Windows ist es standardmäßig nicht möglich, “einfach“ die Linux Distribution Ubuntu zu installieren. Dazu muss vorab erst das WSL2 aktiviert / installiert werden werden (Punkt 1). Im Anschluss ist eine Installation von Ubuntu (18.04 oder 20.04 oder höher) möglich. Zudem muss Docker installiert werden, in dem dann die Entwicklungsumgebung laufen kann (Punkt 2).

  1. WSL2 unter Windows10 aktivieren und Ubuntu 20.04 installieren:

    1. Aus dem Microsoft-Store: https://aka.ms/wslstorepage (verfügbar seit Nov. 2022)

    2. Manuell unter https://learn.microsoft.com/de-de/windows/wsl/install#manual-installation-steps

  2. Docker für Windows installieren: https://docs.docker.com/docker-for-windows/install/

  3. Unter Windows muss in der Hosts-Datei (%windir%\system32\drivers\etc) folgende Eintragung gemacht werden:

Install software (EN)

To install Ubuntu Linux distribution under Windows you first have to activate WSL2 (see item 1). Afterwards a Linux installation of Ubuntu (18.04 or 20.04 or higher) is possible. Additionally docker application needs to be installed (see item 2).

  1. activate WSL2 in Windows10 and install Ubuntu 20.04:

    1. From Microsoft-Store: https://aka.ms/wslstorepage (available since Nov. 2022)

    2. Manually installation see: https://learn.microsoft.com/en-us/windows/wsl/install#manual-installation-steps

  2. Install Docker for Windows:

  3. Add the following two lines in your Windows “host” file (%windir%\system32\drivers\etc):

127.0.0.1 docker.team-opencaching.de 127.0.0.1 try.docker.team-opencaching.de

Im Anschluss wird Ubuntu gestartet (z.B. im “Such“-Menü nach Ubuntu suchen und anklicken). Beim erstmaligen Starten von Ubuntu müssen ein Benutzername und ein Passwort festgelegt werden.

Im Anschluss den Punkten folgen und ausführen, die im nächsten Schritt “Linux” beschrieben werden.

Start Ubuntu (e.g. by typing “Ubuntu” in start menu and clicking on it). During the first start a username and password need to be defined.

Now follow the steps described below in section “Linux”.

 

Linux:

Der Linuxartikel wurde erstellt auf Lubuntu 18.04, aktualisiert mit 22.04 und erweitert mit Debian 12

Programme installieren

Folgende Programme sind notwendig und müssen vorab installiert werden:
PHP (aktuell mind. PHP7.4, später PHP8), diverse PHP-Erweiterungen, docker-compose, mariadb-client.

Für die PHP-Erweiterungen ist eventuell ein zusätzliches PPA-Repository notwendig. Dessen Installation erfordert je nach Betriebssystem ein unterschiedliches Vorgehen.

Ubuntu

sudo apt install software-properties-common sudo add-apt-repository ppa:ondrej/php

Debian

sudo apt install software-properties-common ca-certificates lsb-release apt-transport-https curl -sSL https://packages.sury.org/php/README.txt | sudo bash -x

Die Pakete lassen sich mit folgenden Befehlen installieren (Versionsnummer kann abweichen).

Sollten beim Installieren der Pakete Fehlermeldungen kommen, ist es empfehlenswert, die Pakete einzeln zu installieren und auftretende Fehler/Abhängigkeiten einzeln zu lösen.

 

Nutzer in docker-Gruppe aufnehmen

Der aktuelle Benutzer muss in die Gruppe “docker” aufgenommen werden, sonst kann es passieren, dass dieser keinen Zugriff auf die Dockercontainer bekommt.

Die Änderung wird aber erst nach einem Ab-/Anmelden des Nutzers wirksam.

Überprüft werden kann dies danach mittels

Hier muss die “docker”-Gruppe aufgelistet sein. Beispiel:

 


Eigenschaften der Docker Socket Datei prüfen

Den folgenden Befehl ausführen, um die Eigenschaften der Datei anzeigen zu lassen:

Die Datei muss dabei ‘docker’ zugewiesen sein:

Ist dies nicht der Fall, muss die Zugehörigkeit geändert werden:

 

 

Weiter geht’s mit