diff options
author | Micah Lee <micah@micahflee.com> | 2023-06-04 12:21:31 -0700 |
---|---|---|
committer | Micah Lee <micah@micahflee.com> | 2023-06-04 12:21:31 -0700 |
commit | a0bca420ca340a95fc60b3351f128fcafde796cd (patch) | |
tree | ef97d01d47a578e5990b0ca9e11b3eb092d793ed | |
parent | 66a4c07383ab1462e7f1bdbb790328b62cc0c0d8 (diff) | |
download | onionshare-a0bca420ca340a95fc60b3351f128fcafde796cd.tar.gz onionshare-a0bca420ca340a95fc60b3351f128fcafde796cd.zip |
Add instructions for manually installing via Flatpak and Snapcraft
-rw-r--r-- | docs/source/install.rst | 25 |
1 files changed, 25 insertions, 0 deletions
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 <https://docs.flatpak.org/en/latest/single-file-bundles.html>`_, 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 |