====== Installation einer NGX Instanz auf Debian 13 ======

Wir haben für NGX Installationen eine eigene Routine entwickelt, die es ermöglicht NGX Installationen innerhalb weniger Minuten umzusetzen, dies mit wenigen Kommandos. Das Tool für die Installation nennt sich hier LinuxPrepare und ist .NET-basierend auf .NET 8+.

===== Installation .NET Runtime 8 =====

Für das Ausführen von LinuxPrepare wird eine .NET Runtime benötigt. Diese lässt sich unter Debian wie folgt installieren.

<file>
# Installation von .NET Runtime 8.0 auf Debian 13
# Sollte ohne weitere Vorinstallation so laufen
wget https://packages.microsoft.com/config/debian/13/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install -y dotnet-sdk-8.0
</file>

===== Installation von LinuxPrepare =====

<file>
sudo apt-get install unzip
mkdir -p /tmp/LinuxPrepare
rm /tmp/LinuxPrepare* -r
wget http://xxx/downloads/LinuxPrepare.zip -O /tmp/LinuxPrepare/LinuxPrepare.zip
unzip /tmp/LinuxPrepare/LinuxPrepare.zip -d /tmp/LinuxPrepare
</file>

===== Beispiele von LinuxPrepare =====

LinuxPrepare unterstützt zzt. folgende Workloads:

  * Apache 2 Installation mit Proxy (apache)
  * Paperless NGX Installation mit Host Definition für Apache und Letsencrypt (paperless)
  * UFW Firewall Installation (firewall)
  * Let's Encrypt Bot Installation (letsencrypt)

<file>

# Apache 2 Installation für Reverse-Proxy
dotnet LinuxPrepare.dll -a apache

# Paperless Installation mit PostGres, Tika, Gotenberg und Django
dotnet LinuxPrepare.dll -a paperless -hostname ngxtest.issp.gmbh -apache

# UFW Firewallinstallation, SSH 22 von außen zulassen, Apache(80)/443 tcp, Intranet immer zulassen
# Wichtig: Apache muss bereits installiert sein, da nur dann die Apache Applikation registriert ist
# Ist das nicht der Fall hier 80/tcp anstatt Apache verwenden
dotnet LinuxPrepare.dll -a firewall -allow "Apache,443/tcp" -intranetmask 192.168.100.0/24 -allowintranet on

# UFW ist deaktiviert per Default
ufw enable
ufw status verbose

# LetsEncrypt Certbot installieren (Silent)
dotnet LinuxPrepare.dll -a letsencrypt -email myadmin@example.com

</file>