Instalación

Windows o macOS

Puedes descargar OnionShare para Windows o macOS desde la página web de OnionShare.

Mobile

You can download OnionShare for Mobile from the follow links

Linux

Hay varias maneras de instalar OnionShare para Linux, pero la recomendada es usar el paquete Flatpak o bien Snapcraft. Flatpak y Snap aseguran que siempre usará la versión más nueva, y ejecutará OnionShare dentro en un sandbox.

Snap está incorporado en Ubuntu, y Flatpak en Fedora, pero es tu elección cuál usar. Ambos funcionan en todas las distribuciones Linux.

Instala OnionShare usando Flatpak: https://flathub.org/apps/details/org.onionshare.OnionShare

Instala OnionShare usando Snapcraft: https://snapcraft.io/onionshare

También puedes descargar e instalar paquetes .flatpak o .snap firmados con PGP desde https://onionshare.org/dist/ si así lo prefieres.

Instalación manual con Flatpak

Si deseas instalar OnionShare manualmente con Flatpak usando el paquete de un solo archivo firmado por PGP, puedes hacerlo así como este:

  • Instala Flatpak siguiendo las instrucciones en https://flatpak.org/setup/.

  • Agrega el repositorio de Flathub ejecutando flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo. Aunque no descargará OnionShare desde Flathub, OnionShare depende de algunos paquetes que solo están disponibles allí.

  • Ve a https://onionshare.org/dist/, elige la última versión de OnionShare y descarga los archivos .flatpak y .flatpak.asc.

  • Verifica la firma PGP del archivo .flatpak. Consulta Verificar firmas PGP para obtener más información.

  • Instala el archivo .flatpak ejecutando flatpak install OnionShare-VERSION.flatpak. Reemplaza VERSION con el número de la versión del archivo que descargaste.

Puedes ejecutar OnionShare con: flatpak run org.onionshare.OnionShare.

Instalación manual de Snapcraft

Si quieres instalar OnionShare manualmente con Snapcraft usando el paquete Snapcraft firmado con PGP, puedes hacerlo así:

  • Instala Snapcraft siguiendo las instrucciones de https://snapcraft.io/docs/installing-snapd.

  • Vete a https://onionshare.org/dist/, elije la última versión de OnionShare y descarga los archivos .snap y .snap.asc.

  • Verifica la firma PGP del archivo .snap. Consulta Verificar firmas PGP para obtener más información.

  • Instala el archivo .snap ejecutando snap install --dangerousionsonshare_VERSION_amd64.snap. Reemplaza VERSION con el número de versión del archivo que descargaste. Ten en cuenta que debes usar –dangerous porque el paquete no está firmado por la tienda de Snapcraft, sin embargo, verificó tu firma PGP, por lo que sabe que es legítimo.

Puedes ejecutar OnionShare con: snap run onionshare.

Sólo línea de comandos

Puedes instalar sólo la versión de línea de comandos de OnionShare en cualquier sistema operativo utilizando el gestor de paquetes de Python pip. Interfaz de línea de comando tiene más información.

FreeBSD

Althought not being officially developed for this platform, OnionShare can also be installed on FreeBSD. It’s available via its ports collection or as pre-built package. Should you opt to install and use OnionShare on a FreeBSD operating system, please be aware that it’s NOT officially supported by the OnionShare project.

Though not being offered and officially maintained by the OnionShare developers, the FreeBSD packages and ports do fetch and verifies the source codes from the official OnionShare repository (or its official release packages from PyPI). Should you wish to check changes related to this platform, please refer to the following resources:

Manual pkg Installation

To install the binary package, use pkg install pyXY-onionshare, with pyXY specifying the version of Python the package was built for. So, in order to install OnionShare for Python 3.9, use:

pkg install py39-onionshare

There’s also a Command-line only version of OnionShare available as pre-built package. Replace py39-onionshare by py39-onionshare-cli if you want to install that version.

For additional information and details about the FreeBSD pre-built packages, please refer to its official Handbook section about pkg.

Manual port Installation

To install the FreeBSD port, change directory to the ports collection you must have checked out before and run the following:

make -s -C www/onionshare all install clean

The ports collection also offers a dedicated port for the Command-line only version of OnionShare. Replace www/onionshare by www/onionshare-cli if you want to install that version.

For additional information and details about the FreeBSD ports collection, please refer to its official Handbook section about ports.

Verificar firmas PGP

Puedes verificar que el paquete que descargaste sea legítimo y no haya sido manipulado al verificar su firma PGP. Para Windows y macOS, este paso es opcional, y provee defensa en profundidad: los ejecutables OnionShare incluyen firmas específicas del sistema operativo, y puedes confiar solo en ellas si así lo prefieres.

Clave de firma

Packages are signed by the core developer who is responsible for the particular release. Following are the informations of the core developers of OnionShare:

Para verificar firmas, debes tener GnuPG instalado. Para macOS probablemente quieras GPGTools, y para Windows, Gpg4win.

Firmas

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.

Verificando

Once you have imported the core developers public keys into your GnuPG keychain, downloaded the binary and .asc signature, you can verify the binary in a terminal like this:

For Windows:

gpg --verify OnionShare-win64-2.6.msi.asc OnionShare-win64-2.6.msi (Windows 64-bit)

For macOS:

gpg --verify OnionShare-2.6.dmg.asc OnionShare-2.6.dmg

For Linux:

gpg --verify OnionShare-2.6.flatpak.asc OnionShare-2.6.flatpak (Flatpak)

gpg --verify onionshare_2.6_amd64.snap.asc onionshare_2.6_amd64.snap (Snap)

and for the source file:

gpg --verify onionshare-2.6.tar.gz.asc onionshare-2.6.tar.gz

La salida esperada se parece a esta:

gpg: Signature made Mo 10 Okt 2022 02:27:16 CEST
gpg:                using RSA key 927F419D7EC82C2F149C1BD1403C2657CD994F73
gpg: Good signature from "Micah Lee <micah@micahflee.com>" [unknown]
gpg:                 aka "Micah Lee <micah.lee@firstlook.media>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: 927F 419D 7EC8 2C2F 149C  1BD1 403C 2657 CD99 4F73

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.

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.

Si quieres aprender más acerca de la verificación de firmas PGP, las guías para Qubes OS y el Tor Project podrían ser útiles.