Skip to content

Commit 40c4827

Browse files
findesghproblame
findesgh
and
problame
authored
docs: add installation instructions for openSUSE (#776) (#869)
Added installation instructions for openSUSE as discussed in #776. Sorry for the delay. I decided against a solution involving lsb_release, since openSUSE MicroOS, being a minimal OS, ships without it. Hope the edit is OK. --------- Co-authored-by: Christian Schwarz <[email protected]>
1 parent e524b60 commit 40c4827

1 file changed

Lines changed: 34 additions & 9 deletions

File tree

‎docs/installation/rpm-repos.rst‎

Lines changed: 34 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,25 +6,50 @@ RPM repositories
66
We provide a single RPM repository for all RPM-based Linux distros.
77
The zrepl binary in the repo is the same as the one published to GitHub.
88
Since 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.
910

10-
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``.
1113
It 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.
1314

14-
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+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1625

17-
::
26+
For ``dnf``/``yum``-based distributions, copy-paste the following snippet:
1827

28+
.. 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
2541
26-
.. 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
2755
28-
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.

0 commit comments

Comments
 (0)