Homelab

Appearance

Server Einrichtung ​

Achtung!

Die Server Einrichtung ist grundsätzlich ein einmaliges Ereignis und sollte von Administratoren durchgeführt werden. Sämtliche hier genannten Schritte sind potenziell destruktiv und verändern den Zustand des Servers.

Vorbereitung ​

  1. Verbinde den Mini-PC mit dem Router (über LAN-Kabel)
  2. Monitor anschließen (über HDMI-Kabel (gleicher Kanal wie der Monitor))
  3. Tastatur und Maus anschließen (über USB-Kabel)
  4. Flashe einen USB-Stick mit der gewünschten Linux-Distribution
bash
# Alle Laufwerke auflisten
diskutil list

# USB identifizieren
# USB aushängen
diskutil unmountDisk /dev/disk6

# Linux ISO herunterladen
# z.B. https://cdimage.debian.org/cdimage/release/current/amd64/iso-cd/

# Linux ISO auf USB schreiben
sudo dd if=$HOME/Downloads/debian-13.1.0-amd64-netinst.iso of=/dev/rdisk6 bs=4m status=progress

# USB auswerfen
diskutil eject /dev/disk6
  1. USB-Stick in USB Port des Mini-PCs stecken
  2. Stromkabel anschließen und verbinden

Booten ​

  1. Einschalten und wiederholt F7 drücken
  2. Wähle "Installieren" (nicht "Grafik-Installation")
  3. Wähle das USB-Laufwerk
  4. Schließe die Installation ab, bis ein hellblauer Hintergrund mit drei Auswahlmöglichkeiten angezeigt wird
  5. Dort wähle "UEFI-Firmware-Einstellungen" > Erweitert > ACPI-Einstellungen
  6. Setze "Enable Hibernation" auf "Disabled" (verhindert den Ruhezustand)
  7. Setze "ACPI Ruhezustand" auf "Suspend Disabled"
  8. Speichern, beenden und booten

Die Schritte 5-7 können auch über die Konsole aktiviert werden:

bash
sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target

INFO

Dieser Befehl kann verwendet werden, um zu prüfen, ob die Ruhezustände aktiviert sind. masked bedeutet, dass der Ruhezustand deaktiviert ist.

bash
systemctl is-enabled sleep.target suspend.target hibernate.target hybrid-sleep.target

Server Konfiguration ​

1. Repository klonen ​

bash
git clone https://github.com/timonrieger/homelab.git
cd homelab

2. Mise installieren ​

Installiere mise und richte das Projekt ein:

bash
mise run setup

3. Konfigurationsdateien vorbereiten ​

bash
# Alle Beispieldateien zu Konfigurationsdateien kopieren
find . -name "*.example" -type f | while read example_file; do
  config_file="${example_file%.example}"
  cp "$example_file" "$config_file"
done

Passe alle REPLACE-ME Platzhalter in den kopierten Dateien mit den richtigen Werten an.

4. Tailscale einrichten ​

Richte Tailscale auf dem Server ein, sodass du über Tailscale SSH auf den Server zugreifen kannst.

5. Inventory konfigurieren ​

Passe die inventory.ini Datei mit deinem eingerichteten Benutzernamen an:

ini
[beelink]
beelink ansible_user=<dein-username>

6. Verbindung testen ​

bash
mise run ansible:ping

7. Server einrichten ​

bash
mise run ansible:setup-server

8. Backups konfigurieren ​

bash
mise run ansible:setup-backups

9. Berechtigungen einrichten ​

bash
mise run ansible:setup-permissions

Mehr Details: Zugriffskontrolle