95 lines
2.9 KiB
Markdown
95 lines
2.9 KiB
Markdown
# 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](https://scoop.sh/) nutzt, kannst du Sanctum direkt über das bereitgestellte Manifest installieren:
|
|
|
|
```powershell
|
|
# 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:
|
|
|
|
```powershell
|
|
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:
|
|
```powershell
|
|
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.4.0](https://gitea.pansi.eu/harald/sanctum/releases/tag/v0.4.0)
|
|
* **Datei:** `sanctum-v0.4.0-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ü:
|
|
```powershell
|
|
.\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:
|
|
```bash
|
|
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):
|
|
```bash
|
|
sanctum register
|
|
```
|
|
*Richtet die `.desktop`-Datei und den MIME-Typ `application/x-sanctum` im Userland (`~/.local/share`) ein.*
|
|
|
|
---
|
|
|
|
## 🔄 Updates
|
|
|
|
* **Scoop:**
|
|
```powershell
|
|
scoop update sanctum
|
|
```
|
|
* **Winget:**
|
|
```powershell
|
|
winget upgrade --manifest .\packages\winget\HaraldPansi.Sanctum.yaml
|
|
```
|
|
|
|
---
|
|
|
|
## 🗑️ Deinstallation
|
|
|
|
* **Scoop:**
|
|
```powershell
|
|
scoop uninstall sanctum
|
|
```
|
|
* **Explorer-Kontextmenü rückstandslos bereinigen:**
|
|
```powershell
|
|
sanctum.exe unregister
|
|
```
|