Files
sanctum/INSTALL.md
T
harald 4ef0c414fa
Sanctum Release / Build & Release (Windows x86_64) (push) Canceled after 0s
feat(linux): add static musl x86_64 build, packaging, and Freedesktop integration
2026-09-10 17:45:04 +02:00

2.9 KiB

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:
  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).

🐧 4. Installation unter Linux (x86_64)

Sanctum wird für Linux als 100 % statisches Single-Binary (x86_64-unknown-linux-musl) ohne jegliche GLIBC- oder Bibliotheksabhängigkeiten bereitgestellt. Es läuft direkt auf Ubuntu, Debian, Alpine, Arch, Fedora und weiteren Distributionen:

  1. Lade das Linux-Release herunter und installiere es:
    curl -LO https://gitea.pansi.eu/harald/sanctum/releases/download/v0.4.0/sanctum-v0.4.0-linux-x86_64.tar.gz
    tar -xzf sanctum-v0.4.0-linux-x86_64.tar.gz
    chmod +x sanctum
    sudo install -m 755 sanctum /usr/local/bin/sanctum
    
  2. (Optional) Freedesktop-Integration einrichten (Doppelklick in GNOME / KDE / Thunar):
    sanctum register
    
    Richtet die .desktop-Datei und den MIME-Typ application/x-sanctum im Userland (~/.local/share) ein.

🔄 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