mirror of
https://github.com/onionshare/onionshare.git
synced 2025-07-28 17:17:34 -04:00
Update build instructions to include Linux instructions using the newest software, instead of just software from package repositories
This commit is contained in:
parent
714749cda6
commit
aca893755c
1 changed files with 50 additions and 4 deletions
54
BUILD.md
54
BUILD.md
|
@ -1,8 +1,8 @@
|
||||||
# Index
|
# Index
|
||||||
* [Building OnionShare](#building-onionshare)
|
* [Building OnionShare](#building-onionshare)
|
||||||
* [Linux](#linux)
|
* [Linux](#linux)
|
||||||
* [For Debian-like distros](#for-debian-like-distros)
|
* [Use newest software](#use-newest-software)
|
||||||
* [For Fedora-like distros](#for-fedora-like-distros)
|
* [Use package managers](#use-package-managers)
|
||||||
* [macOS](#macos)
|
* [macOS](#macos)
|
||||||
* [Windows](#windows)
|
* [Windows](#windows)
|
||||||
* [Setting up your dev environment](#setting-up-your-dev-environment)
|
* [Setting up your dev environment](#setting-up-your-dev-environment)
|
||||||
|
@ -28,15 +28,61 @@ cd onionshare
|
||||||
|
|
||||||
## Linux
|
## Linux
|
||||||
|
|
||||||
|
### Use newest software
|
||||||
|
|
||||||
|
The recommended way to develop OnionShare is to use the latest versions of all dependencies.
|
||||||
|
|
||||||
|
First, install `tor` from either the [official Debian repository](https://support.torproject.org/apt/tor-deb-repo/), or from your package manager.
|
||||||
|
|
||||||
|
Then download Qt 5.14.0 for Linux:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
cd ~/Downloads
|
||||||
|
wget https://download.qt.io/official_releases/qt/5.14/5.14.0/qt-opensource-linux-x64-5.14.0.run
|
||||||
|
```
|
||||||
|
|
||||||
|
If you'd like to check to make sure you have the exact installer I have, here is the sha256 checksum:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sha256sum qt-opensource-linux-x64-5.14.0.run
|
||||||
|
4379f147c6793ec7e7349d2f9ee7d53b8ab6ea4e4edf8ee0574a75586a6a6e0e qt-opensource-linux-x64-5.14.0.run
|
||||||
|
```
|
||||||
|
|
||||||
|
Then make it executable and install Qt:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
chmod +x qt-opensource-linux-x64-5.14.0.run
|
||||||
|
./qt-opensource-linux-x64-5.14.0.run
|
||||||
|
```
|
||||||
|
|
||||||
|
You have to create a Qt account and login to install Qt. Choose the default installation folder in your home directory. The only component you need is `Qt 5.14.0` > `Desktop gcc 64-bit`.
|
||||||
|
|
||||||
|
Install [poetry](https://python-poetry.org/docs/) from your package manager, or by doing `pip install --user poetry`. Then install dependencies:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
poetry install
|
||||||
|
```
|
||||||
|
|
||||||
|
You can run the CLI and the GUI versions of OnionShare like this:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
poetry run ./dev_scripts/onionshare
|
||||||
|
poetry run ./dev_scripts/onionshare-gui
|
||||||
|
```
|
||||||
|
|
||||||
|
### Use package managers
|
||||||
|
|
||||||
|
Alternatively, you can install dependencies from package managers.
|
||||||
|
|
||||||
Install the needed dependencies:
|
Install the needed dependencies:
|
||||||
|
|
||||||
#### For Debian-like distros:
|
**For Debian-like distros:**
|
||||||
|
|
||||||
```
|
```
|
||||||
apt install -y python3-flask python3-stem python3-pyqt5 python3-crypto python3-socks python-nautilus tor obfs4proxy python3-pytest python3-pytestqt build-essential fakeroot python3-all python3-stdeb dh-python python3-flask-httpauth python3-distutils python3-psutil python3-watchdog
|
apt install -y python3-flask python3-stem python3-pyqt5 python3-crypto python3-socks python-nautilus tor obfs4proxy python3-pytest python3-pytestqt build-essential fakeroot python3-all python3-stdeb dh-python python3-flask-httpauth python3-distutils python3-psutil python3-watchdog
|
||||||
```
|
```
|
||||||
|
|
||||||
#### For Fedora-like distros:
|
**For Fedora-like distros:**
|
||||||
|
|
||||||
```
|
```
|
||||||
dnf install -y python3-flask python3-flask-httpauth python3-stem python3-qt5 python3-crypto python3-pysocks nautilus-python tor obfs4 python3-pytest rpm-build python3-psutil python3-watchdog
|
dnf install -y python3-flask python3-flask-httpauth python3-stem python3-qt5 python3-crypto python3-pysocks nautilus-python tor obfs4 python3-pytest rpm-build python3-psutil python3-watchdog
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue