From a0bca420ca340a95fc60b3351f128fcafde796cd Mon Sep 17 00:00:00 2001 From: Micah Lee Date: Sun, 4 Jun 2023 12:21:31 -0700 Subject: Add instructions for manually installing via Flatpak and Snapcraft --- docs/source/install.rst | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/source/install.rst b/docs/source/install.rst index a44b659e..9d91ffcb 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -22,6 +22,31 @@ Snapcraft support is built-in to Ubuntu and Fedora comes with Flatpak support, b You can also download and install PGP-signed ``.flatpak`` or ``.snap`` packages from https://onionshare.org/dist/ if you prefer. +Manual Flatpak Installation +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If you'd like to install OnionShare manually with Flatpak using the PGP-signed `single-file bundle `_, you can do so like this: + +- Install Flatpak by following the instructions at https://flatpak.org/setup/. +- Add the Flathub repository by running ``flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo``. Even though you won't be downloading OnionShare from Flathub, OnionShare depends on some packages that are only available there. +- Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the ``.flatpak`` and ``.flatpak.asc`` files. +- Verify the PGP signature of the ``.flatpak`` file. See :ref:`verifying_sigs` for more info. +- Install the ``.flatpak`` file by running ``flatpak install OnionShare-VERSION.flatpak``. Replace ``VERSION`` with the version number of the file you downloaded. + +You can run OnionShare with: `flatpak run org.onionshare.OnionShare`. + +Manual Snapcraft Installation +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If you'd like to install OnionShare manually with Snapcraft using the PGP-signed Snapcraft package, you can do so like this: + +- Install Snapcraft by following the instructions at https://snapcraft.io/docs/installing-snapd. +- Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the ``.snap`` and ``.snap.asc`` files. +- Verify the PGP signature of the ``.snap`` file. See :ref:`verifying_sigs` for more info. +- Install the ``.snap`` file by running ``snap install --dangerous onionshare_VERSION_amd64.snap``. Replace ``VERSION`` with the version number of the file you downloaded. Note that you must use `--dangerous` because the package is not signed by the Snapcraft store, however you did verify it's PGP signature, so you know it's legitimate. + +You can run OnionShare with: `snap run onionshare`. + .. _pip: Command-line only -- cgit v1.2.3-54-g00ecf From 5df7d66571246ecebe7a9d52d780bae36c435e0d Mon Sep 17 00:00:00 2001 From: Miguel Jacq Date: Mon, 5 Jun 2023 10:02:39 +1000 Subject: it's > its --- docs/source/install.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/install.rst b/docs/source/install.rst index 9d91ffcb..3638843e 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -43,7 +43,7 @@ If you'd like to install OnionShare manually with Snapcraft using the PGP-signed - Install Snapcraft by following the instructions at https://snapcraft.io/docs/installing-snapd. - Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the ``.snap`` and ``.snap.asc`` files. - Verify the PGP signature of the ``.snap`` file. See :ref:`verifying_sigs` for more info. -- Install the ``.snap`` file by running ``snap install --dangerous onionshare_VERSION_amd64.snap``. Replace ``VERSION`` with the version number of the file you downloaded. Note that you must use `--dangerous` because the package is not signed by the Snapcraft store, however you did verify it's PGP signature, so you know it's legitimate. +- Install the ``.snap`` file by running ``snap install --dangerous onionshare_VERSION_amd64.snap``. Replace ``VERSION`` with the version number of the file you downloaded. Note that you must use `--dangerous` because the package is not signed by the Snapcraft store, however you did verify its PGP signature, so you know it's legitimate. You can run OnionShare with: `snap run onionshare`. -- cgit v1.2.3-54-g00ecf