sanctum/INSTALL.md

Installation & Paketmanager-Guide für Sanctum 🛡️

Sanctum kann auf verschiedene Arten unter Windows 10/11 installiert und verwaltet werden. Es sind keine Administratorrechte erforderlich.

---

🚀 1. Installation via Scoop (Empfohlen für Entwickler)

Wenn du den Windows-Paketmanager Scoop nutzt, kannst du Sanctum direkt über das bereitgestellte Manifest installieren:

# Direkt über die URL des Manifests installieren:
scoop install https://gitea.pansi.eu/harald/sanctum/raw/branch/main/packages/scoop/sanctum.json

Oder falls du ein lokales Repository geklont hast:

scoop install .\packages\scoop\sanctum.json

Nach der Installation ist der Befehl sanctum sofort global in deiner PowerShell verfügbar.

---

🪟 2. Installation via Windows Package Manager (Winget)

Sanctum verfügt über ein standardkonformes Winget-Manifest (Schema 1.6.0).

Lokale Installation via Manifest:

winget install --manifest .\packages\winget\HaraldPansi.Sanctum.yaml

Winget entpackt das portable Binary automatisch in das Benutzer-Anwendungsverzeichnis und verknüpft das Alias sanctum.

---

📦 3. Manuelle Installation (Standalone Portable)

1. Lade das aktuelle Release-Paket herunter:
   • URL: https://gitea.pansi.eu/harald/sanctum/releases/tag/v0.3.1
   • Datei: sanctum-v0.3.1-windows-x86_64.zip
2. Entpacke das Archiv in ein Verzeichnis deiner Wahl (z. B. C:\Tools\Sanctum\).
3. (Optional) Registriere das Windows Explorer Rechtsklick-Kontextmenü:

   .\sanctum.exe register
   

   (Erlaubt das Einhängen per Rechtsklick "In Sanctum öffnen" ohne Adminrechte).

---

🔄 Updates

• Scoop:

  scoop update sanctum
  

• Winget:

  winget upgrade --manifest .\packages\winget\HaraldPansi.Sanctum.yaml
  

---

🗑️ Deinstallation

• Scoop:

  scoop uninstall sanctum
  

• Explorer-Kontextmenü rückstandslos bereinigen:

  sanctum.exe unregister