# APT repository para sa Ubuntu / Debian

Naglalathala ang CH-J Alpha repository ng mga opisyal na amd64 DEB package. Para ito sa Ubuntu 24.04 at sa mga compatible na desktop system; hindi ginagarantiya ang compatibility sa bawat release ng Debian. Naka-sign ang metadata ng repository gamit ang OpenPGP signing subkey ng CH-J na nakaimbak sa isang YubiKey. Hindi kailanman ina-upload sa web server ang private key.

## I-verify ang key at i-enable ang repository

Ang inaasahang pangunahing fingerprint ay:

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

I-download ang pampublikong key at suriin ang fingerprint nito bago ito i-install. Kunin nang independiyente ang inaasahang fingerprint mula sa README ng CH-J o mula sa isang kopya ng application na pinagkakatiwalaan mo na.

```bash
curl -fsSLo ch-j-archive-keyring.gpg https://sm.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
```

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

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

Pagkatapos ay mag-install:

```bash
sudo apt update
sudo apt install ch-j-server-manager
```

Gumagamit ang mga susunod na update ng `sudo apt update` na sinusundan ng `sudo apt upgrade`. Tumataas ang bersyon sa DEB control file sa bawat release; gumagamit ang mga pre-release identifier ng `~` para tama ang pagkakasunod-sunod ng susunod na stable na bersyon. Pinananatili rin ng bawat release ang natatanging Build ID ng application nito. Sa ngayon, ang alpha suite lamang ang may mga package; may mga walang lamang naka-sign na index ang beta at stable hanggang may totoong release na maitalaga sa mga channel na iyon. (`alpha`, `beta`, `stable`)

## Gabay at lisensya

Hindi maaasahang maipapakita ng APT ang isang interactive na lisensya bago ang pag-install. Sa unang paglulunsad at pagkatapos ng mga update, ipinapakita ng application ang kumpletong gabay sa operasyon sa CS/DE/EN, kasunod ang CH-J Proprietary Software License 1.14 at isang mandatoryong checkbox para sa pagsang-ayon sa mga tuntunin ng lisensya at sa abiso tungkol sa pagkawala ng data/mga backup. Ang pagtanggi sa lisensya o pagsara sa window nito ay magsasara sa application. Nananatiling pang-impormasyon at hindi umiiral ang gabay sa operasyon.

Gamitin ang APT para i-update ang mga installation mula sa repository. Huwag patakbuhin ang hiwalay na installer ng application habang may APT transaction. Patuloy na sinusuportahan ng internal updater ang mga installation na hindi mula sa repository na ito.

Gumagamit ang metadata ng repository ng `InRelease` at `Release.gpg`, mga SHA-256/SHA-512 index at mga content-addressed index para sa pare-parehong mga update. Nililimitahan ng `Signed-By` ang tiwala sa repository na ito. Huwag gamitin ang global na tiwala ng `apt-key`. Huwag kailanman i-disable ang pag-verify ng signature. [Gabay ng Debian tungkol sa mga third-party repository](https://wiki.debian.org/DebianRepository/UseThirdParty).