@@ -6,25 +6,50 @@ RPM repositories
66We provide a single RPM repository for all RPM-based Linux distros.
77The zrepl binary in the repo is the same as the one published to GitHub.
88Since Go binaries are statically linked, the RPM should work about everywhere.
9+Please open an issue on GitHub if you encounter any issues with the repository.
91010-The fingerprint of the signing key is ``F6F6 E8EA 6F2F 1462 2878 B5DE 50E3 4417 826E 2CE6``.
11+The fingerprint of the repo & package signing key is:
12+``F6F6 E8EA 6F2F 1462 2878 B5DE 50E3 4417 826E 2CE6``.
1113It is available at `<https://zrepl.cschwarz.com/rpm/rpm-key.asc>`_ .
12-Please open an issue on GitHub if you encounter any issues with the repository.
131414-Copy-paste the following snippet into your shell to set up the zrepl repository.
15-Then ``dnf install zrepl`` and make sure to confirm that the signing key matches the one shown above.
15+.. NOTE::
16+17+ Until zrepl reaches 1.0, the repository will be updated to the latest zrepl release immediately.
18+ This includes breaking changes between zrepl versions.
19+ If that bothers you, use the `dnf versionlock plugin <https://dnf-plugins-core.readthedocs.io/en/latest/versionlock.html>`_ or ``zypper addlock zrepl`` to pin the version of zrepl on your system.
20+21+22+23+Fedora / AlmaLinux / Rocky Linux / RHEL
24+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
162517-::
26+For ``dnf``/``yum``-based distributions, copy-paste the following snippet:
182728+.. code-block:: bash
29+30+ rpmkeys --import 'https://zrepl.cschwarz.com/rpm/rpm-key.asc'
1931 cat > /etc/yum.repos.d/zrepl.repo <<EOF
2032 [zrepl]
2133 name = zrepl
2234 baseurl = https://zrepl.cschwarz.com/rpm/repo
2335 gpgkey = https://zrepl.cschwarz.com/rpm/rpm-key.asc
36+ repo_gpgcheck = 1
2437 EOF
38+ dnf install zrepl
39+ # Or if you're on an older system:
40+ # yum install zrepl
254126-.. NOTE::
42+You will be asked by dnf to verify repository metadata (``repo_gpgcheck``).
43+There is no way to automate that prompt.
44+45+openSUSE
46+^^^^^^^^
47+48+For SUSE-based distributions that use ``zypper``, copy-paste the following snippet:
49+50+.. code-block:: bash
51+52+ rpmkeys --import 'https://zrepl.cschwarz.com/rpm/rpm-key.asc'
53+ zypper ar --check --gpgcheck-strict --refresh https://zrepl.cschwarz.com/rpm/repo zrepl
54+ zypper install zrepl
275528- Until zrepl reaches 1.0, the repository will be updated to the latest zrepl release immediately.
29- This includes breaking changes between zrepl versions.
30- If that bothers you, use the `dnf versionlock plugin <https://dnf-plugins-core.readthedocs.io/en/latest/versionlock.html>`_ to pin the version of zrepl on your system.