# APT-Repository für Ubuntu / Debian

Das Repository von CH-J veröffentlicht das offizielle DEB-Paket für amd64 von CH-J Tools (`ch-j-tools`). Es ist für Ubuntu 24.04 und kompatible Desktop-Systeme vorgesehen; die Kompatibilität mit jeder Debian-Version ist nicht garantiert. Die Repository-Metadaten sind mit dem CH-J-OpenPGP-Signierunterschlüssel signiert, der auf einem YubiKey liegt. Der private Schlüssel wird niemals auf den Webserver hochgeladen.

## Schlüssel prüfen und Repository aktivieren

Der erwartete primäre Fingerabdruck lautet:

```text
0D92 778A D8EC F85C 80E3 9248 48F2 433A D9CD F453
```

Laden Sie den öffentlichen Schlüssel herunter und prüfen Sie seinen Fingerabdruck vor der Installation. Beziehen Sie den erwarteten Fingerabdruck unabhängig aus dem CH-J-README oder aus einer bereits vertrauenswürdigen Kopie der Anwendung.

```bash
curl -fsSLo ch-j-archive-keyring.gpg https://tools.ch-j.cz/apt/ch-j-archive-keyring.gpg
gpg --show-keys --with-fingerprint ch-j-archive-keyring.gpg
sudo install -d -m 0755 /etc/apt/keyrings
sudo install -m 0644 ch-j-archive-keyring.gpg /etc/apt/keyrings/ch-j-archive-keyring.gpg
```

Erstellen Sie `/etc/apt/sources.list.d/ch-j.sources`:

```text
Types: deb
URIs: https://tools.ch-j.cz/apt/
Suites: beta
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/ch-j-archive-keyring.gpg
```

Anschließend installieren:

```bash
sudo apt update
sudo apt install ch-j-tools
```

Wenn Sie das frühere Paket `ch-j-server-manager` aus diesem Repository installiert haben, ändern Sie `Suites` auf `beta` und führen Sie dieselben Befehle aus. `ch-j-tools` ersetzt das alte Paket, und die Anwendung verschiebt ihren Datenordner beim ersten Start.

Spätere Aktualisierungen erfolgen mit `sudo apt update` und anschließend `sudo apt upgrade`. Die Version in der DEB-Steuerdatei steigt mit jeder Veröffentlichung; Vorabversionen verwenden `~`, damit eine spätere stabile Version korrekt einsortiert wird. Jede Veröffentlichung behält außerdem ihre eindeutige Build-ID der Anwendung.

| `alpha` | `beta` | `stable` |
| --- | --- | --- |
| `ch-j-server-manager` 0.1.1 | `ch-j-tools` 0.1.2 | — |

## Hinweise und Lizenz

APT kann vor der Installation keine interaktive Lizenz zuverlässig anzeigen. Beim ersten Start und nach einer Aktualisierung zeigt die Anwendung die vollständigen Betriebshinweise CS/DE/EN an, danach die CH-J Proprietary Software License 1.14 und ein Pflicht-Kontrollkästchen, mit dem die Lizenzbedingungen sowie der Hinweis auf Datenverlust und Datensicherung bestätigt werden. Das Ablehnen der Lizenz oder das Schließen ihres Fensters beendet die Anwendung. Die Betriebshinweise sind nur informativ und unverbindlich.

Aktualisieren Sie Repository-Installationen mit APT. Starten Sie während einer APT-Transaktion nicht den separaten Installer der Anwendung. Der interne Updater unterstützt weiterhin Installationen außerhalb dieses Repositorys.

Die Repository-Metadaten verwenden `InRelease` und `Release.gpg`, Indizes mit SHA-256/SHA-512 und inhaltsadressierte Indizes für konsistente Aktualisierungen. `Signed-By` beschränkt das Vertrauen auf dieses Repository. Verwenden Sie kein globales Vertrauen über `apt-key`. Deaktivieren Sie niemals die Signaturprüfung. [Debian-Hinweise zu Drittanbieter-Repositorys](https://wiki.debian.org/DebianRepository/UseThirdParty).