From 514395dfe01ca67e2f7aa31c954003d76bf45c7c Mon Sep 17 00:00:00 2001
From: Louis-Alexander Kerst <louis@alexander-kerst.de>
Date: Mon, 24 Aug 2026 22:01:13 +0200
Subject: [PATCH] fix: document git-free plugin installation

---
 store/templates/installation.php | 11 +++++++++--
 store/tests/run.php              |  3 ++-
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/store/templates/installation.php b/store/templates/installation.php
index 3bc65c3..cc854ea 100644
--- a/store/templates/installation.php
+++ b/store/templates/installation.php
@@ -9,9 +9,16 @@
 <section class="shell prose-shell install-guide">
   <aside class="notice"><strong>Vorher sichern:</strong> Erstelle ein Backup von NetBox und der Datenbank. Führe die Befehle auf dem NetBox-Host aus.</aside>
   <h2>1. Plugin aus git.mrblake.cc installieren</h2>
-  <p>Trage das Plugin dauerhaft in <code>/opt/netbox/local_requirements.txt</code> ein. Für reproduzierbare Installationen solltest du <code>main</code> durch einen geprüften Commit-SHA ersetzen.</p>
-  <pre><code>sudo sh -c 'printf "%s\n" "netbox-plugin-store @ git+https://git.mrblake.cc/MrBlake/Netbox-Store.git@main#subdirectory=netbox_plugin" &gt;&gt; /opt/netbox/local_requirements.txt'
+  <p>Trage das Plugin dauerhaft in <code>/opt/netbox/local_requirements.txt</code> ein. Die empfohlene HTTPS-Archivvariante benötigt kein lokal installiertes Git. Für reproduzierbare Installationen solltest du <code>main</code> durch einen geprüften Commit-SHA ersetzen.</p>
+  <pre><code>sudo sh -c 'line="netbox-plugin-store @ https://git.mrblake.cc/MrBlake/Netbox-Store/archive/main.tar.gz#subdirectory=netbox_plugin"; grep -Fqx "$line" /opt/netbox/local_requirements.txt || printf "%s\n" "$line" &gt;&gt; /opt/netbox/local_requirements.txt'
 sudo /opt/netbox/upgrade.sh</code></pre>
+  <h3>Alternative mit Git</h3>
+  <p>Wenn du stattdessen eine <code>git+https</code>-Requirement verwendest, muss das Programm <code>git</code> vor dem NetBox-Upgrade installiert sein:</p>
+  <pre><code>sudo apt update
+sudo apt install -y git
+
+# Requirement:
+netbox-plugin-store @ git+https://git.mrblake.cc/MrBlake/Netbox-Store.git@main#subdirectory=netbox_plugin</code></pre>
   <h2>2. Plugin in NetBox aktivieren</h2>
   <p>Ergänze die NetBox-Konfiguration:</p>
   <pre><code>PLUGINS = [
diff --git a/store/tests/run.php b/store/tests/run.php
index 21948b0..a8f7323 100644
--- a/store/tests/run.php
+++ b/store/tests/run.php
@@ -491,7 +491,8 @@ test('public and admin templates render safely with complete artifact evidence',
     ]);
     assertTrue(str_contains($detail, 'Wheel'));
     $installation = $view->render('installation', $common + ['title' => 'Installation']);
-    assertTrue(str_contains($installation, 'git+https://git.mrblake.cc/MrBlake/Netbox-Store.git'));
+    assertTrue(str_contains($installation, 'https://git.mrblake.cc/MrBlake/Netbox-Store/archive/main.tar.gz'));
+    assertTrue(str_contains($installation, 'sudo apt install -y git'));
     assertTrue(str_contains($installation, 'https://netbox.mrblake.cc'));
     $admin = $view->render('admin/dashboard', [
         'title' => 'Admin', 'currentPath' => '/admin', 'adminEnabled' => true, 'adminUser' => 'admin',