mirror of
https://github.com/onionshare/onionshare.git
synced 2024-12-25 23:39:43 -05:00
190 lines
7.5 KiB
Plaintext
190 lines
7.5 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) Micah Lee, et al.
|
|
# This file is distributed under the same license as the OnionShare package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: OnionShare 2.6.1\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2023-09-05 11:51-0700\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../source/install.rst:2
|
|
msgid "Installation"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:5
|
|
msgid "Windows or macOS"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:7
|
|
msgid "You can download OnionShare for Windows and macOS from the `OnionShare website <https://onionshare.org/>`_."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:12
|
|
msgid "Linux"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:14
|
|
msgid "There are various ways to install OnionShare for Linux, but the recommended way is to use either the `Flatpak <https://flatpak.org/>`_ or the `Snap <https://snapcraft.io/>`_ package. Flatpak and Snapcraft ensure that you'll always use the newest version and run OnionShare inside of a sandbox."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:17
|
|
msgid "Snapcraft support is built-in to Ubuntu and Fedora comes with Flatpak support, but which you use is up to you. Both work in all Linux distributions."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:19
|
|
msgid "**Install OnionShare using Flatpak**: https://flathub.org/apps/details/org.onionshare.OnionShare"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:21
|
|
msgid "**Install OnionShare using Snapcraft**: https://snapcraft.io/onionshare"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:23
|
|
msgid "You can also download and install PGP-signed ``.flatpak`` or ``.snap`` packages from https://onionshare.org/dist/ if you prefer."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:26
|
|
msgid "Manual Flatpak Installation"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:28
|
|
msgid "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:"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:30
|
|
msgid "Install Flatpak by following the instructions at https://flatpak.org/setup/."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:31
|
|
msgid "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."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:32
|
|
msgid "Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the ``.flatpak`` and ``.flatpak.asc`` files."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:33
|
|
msgid "Verify the PGP signature of the ``.flatpak`` file. See :ref:`verifying_sigs` for more info."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:34
|
|
msgid "Install the ``.flatpak`` file by running ``flatpak install OnionShare-VERSION.flatpak``. Replace ``VERSION`` with the version number of the file you downloaded."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:36
|
|
msgid "You can run OnionShare with: `flatpak run org.onionshare.OnionShare`."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:39
|
|
msgid "Manual Snapcraft Installation"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:41
|
|
msgid "If you'd like to install OnionShare manually with Snapcraft using the PGP-signed Snapcraft package, you can do so like this:"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:43
|
|
msgid "Install Snapcraft by following the instructions at https://snapcraft.io/docs/installing-snapd."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:44
|
|
msgid "Go to https://onionshare.org/dist/, choose the latest version of OnionShare, and download the ``.snap`` and ``.snap.asc`` files."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:45
|
|
msgid "Verify the PGP signature of the ``.snap`` file. See :ref:`verifying_sigs` for more info."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:46
|
|
msgid "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."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:48
|
|
msgid "You can run OnionShare with: `snap run onionshare`."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:53
|
|
msgid "Command-line only"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:55
|
|
msgid "You can install just the command-line version of OnionShare on any operating system using the Python package manager ``pip``. :ref:`cli` has more info."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:60
|
|
msgid "Verifying PGP signatures"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:62
|
|
msgid "You can verify that the package you download is legitimate and hasn't been tampered with by verifying its PGP signature. For Windows and macOS, this step is optional and provides defense in depth: the OnionShare binaries include operating system-specific signatures, and you can just rely on those alone if you'd like."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:66
|
|
msgid "Signing key"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:68
|
|
msgid "Packages are signed by Micah Lee, the core developer, using his PGP public key with fingerprint ``927F419D7EC82C2F149C1BD1403C2657CD994F73``. You can download Micah's key `from the keys.openpgp.org keyserver <https://keys.openpgp.org/vks/v1/by-fingerprint/927F419D7EC82C2F149C1BD1403C2657CD994F73>`_."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:71
|
|
msgid "You must have GnuPG installed to verify signatures. For macOS you probably want `GPGTools <https://gpgtools.org/>`_, and for Windows you probably want `Gpg4win <https://www.gpg4win.org/>`_."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:74
|
|
msgid "Signatures"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:76
|
|
msgid "You can find the signatures (as ``.asc`` files), as well as Windows, macOS, Flatpak, Snap, and source packages, at https://onionshare.org/dist/ in the folders named for each version of OnionShare. You can also find them on the `GitHub Releases page <https://github.com/onionshare/onionshare/releases>`_."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:80
|
|
msgid "Verifying"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:82
|
|
msgid "Once you have imported Micah's public key into your GnuPG keychain, downloaded the binary and ``.asc`` signature, you can verify the binary in a terminal like this:"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:84
|
|
msgid "For Windows::"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:88
|
|
msgid "For macOS::"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:92
|
|
msgid "For Linux::"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:98
|
|
msgid "and for the source file::"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:102
|
|
msgid "The expected output looks like this::"
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:112
|
|
msgid "If you don't see ``Good signature from``, there might be a problem with the integrity of the file (malicious or otherwise), and you should not install the package."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:114
|
|
msgid "The ``WARNING:`` shown above, is not a problem with the package, it only means you haven't defined a level of \"trust\" of Micah's (the core developer) PGP key."
|
|
msgstr ""
|
|
|
|
#: ../../source/install.rst:116
|
|
msgid "If you want to learn more about verifying PGP signatures, the guides for `Qubes OS <https://www.qubes-os.org/security/verifying-signatures/>`_ and the `Tor Project <https://support.torproject.org/tbb/how-to-verify-signature/>`_ may be useful."
|
|
msgstr ""
|