APT-repository voor Ubuntu / Debian

# APT-repository voor Ubuntu / Debian

De CH-J-repository publiceert het officiële amd64 DEB-pakket van CH-J Tools (`ch-j-tools`). Het is bedoeld voor Ubuntu 24.04 en compatibele desktopsystemen; compatibiliteit met elke Debian release wordt niet gegarandeerd. De repository metadata is ondertekend met de CH-J OpenPGP ondertekening subkey gehouden op een YubiKey. De private sleutel wordt nooit geüpload naar de webserver.

## Verifiëren van de sleutel en inschakelen van de repository

De verwachte primaire vingerafdrukken zijn:

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

Download de publieke sleutel en controleer zijn vingerafdruk voordat u deze installeert. Verkrijg de verwachte vingerafdruk onafhankelijk van de CH-J README of een reeds vertrouwde toepassingskopie.

```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
```

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

```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
```

Installeer vervolgens:

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

Als u het eerdere pakket `ch-j-server-manager` uit deze repository hebt geïnstalleerd, wijzig dan `Suites` in `beta` en voer dezelfde opdrachten uit. `ch-j-tools` vervangt het oude pakket en de toepassing verplaatst haar gegevensmap bij de eerste start.

Latere updates maken gebruik van `sudo apt update` gevolgd door `sudo apt upgrade`. De versie in het DEB controlebestand neemt toe voor elke release; prerelease identificaties gebruiken `~` zodat een latere stabiele versie correct sorteert. Elke release behoudt ook zijn unieke applicatie build ID.

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

## Richtlijnen en vergunningen

APT kan vóór de installatie geen interactieve licentie op betrouwbare wijze weergeven. Bij de eerste lancering en na een update, toont de applicatie volledige CS/DE/EN operationele begeleiding, gevolgd door CH-J Proprietary Software License 1.14 en een vereiste selectievakje met erkenning van de licentievoorwaarden en de data-loss/backup notificatie. De licentie weigeren of het licentievenster sluiten beëindigt de applicatie. De operationele richtsnoeren blijven informatief en niet bindend.

Gebruik APT voor het bijwerken van repository-installaties. Start niet de aparte installatie van de applicatie tijdens een APT-transactie. De interne updater blijft installaties buiten deze repository ondersteunen.

Repository metadata maakt gebruik van `InRelease` en `Release.gpg`, SHA-256/SHA-512 indexen en inhoud-geadresseerde indexen voor consistente updates. `Signed-By` beperkt het vertrouwen tot deze repository. Gebruik geen globaal vertrouwen via `apt-key`. Schakel de controle van handtekeningen nooit uit. [Debian's derde partij repository guidance](https://wiki.debian.org/DebianRepository/UseThirdParty).