lbry-sdk/INSTALL.md

100 lines
2.8 KiB
Markdown
Raw Normal View History

# Installing LBRY
2015-08-20 17:27:15 +02:00
2017-01-20 18:27:19 +01:00
The recommended way to install LBRY is to use an installer. We provide installers for all major operating systems. See the [README](README.md).
2015-08-20 17:27:15 +02:00
2017-01-29 21:45:11 +01:00
These instructions are for installing from source code, which is recommended if you are interested in doing development work or LBRY is not available on your operating system (godspeed, TempleOS users).
2015-08-20 17:27:15 +02:00
## Prerequisites
2015-08-20 17:27:15 +02:00
Before starting, you'll need to install some additional libraries depending on your operating system.
2015-08-20 17:27:15 +02:00
### OS X Prerequisites
2016-05-23 21:21:47 +02:00
Install [xcode command line tools](https://developer.xamarin.com/guides/testcloud/calabash/configuring/osx/install-xcode-command-line-tools/) and [homebrew](http://brew.sh/).
2016-05-23 21:21:47 +02:00
Remaining dependencies can then be installed by running:
2016-09-22 19:19:28 +02:00
```
brew install mpfr libmpc
sudo easy_install pip
sudo pip install virtualenv
```
### Linux Prerequisites
2016-09-22 19:19:28 +02:00
On Ubuntu (we recommend 16.04), install the following:
2016-09-22 19:19:28 +02:00
```
sudo apt-get install libgmp3-dev build-essential python2.7 python2.7-dev \
python-pip git python-virtualenv libssl-dev libffi-dev
```
If you're running another Linux flavor, install the equivalent of the above packages for your system.
2016-09-22 19:19:28 +02:00
### Windows Prerequisites
Install [mingw32](http://www.mingw.org/) base and c++ compiler.
Add C:\MinGW\bin to the windows PATH.
Enable distutils to compile with mingw32 by creating a distutils.cfg file in *PYTHONPATH\Lib\distutils* containing:
```
[build]
compiler = mingw32
```
If using virtualenv, which is recommended, copy the *PYTHONPATH\Lib\distutils* directory to the virtualenv.
It's recommended to use [Unofficial Windows Binaries for Python Extension Packages](http://www.lfd.uci.edu/~gohlke/pythonlibs/) for as many of the required packages as possible.
Currently, available binaries include:
- Cython
- Twisted
- Zope.interface
- pywin32
- Yapsy
- cx_Freeze
- requests
- gmpy
2017-01-24 17:52:02 +01:00
Install the above binaries with `pip install *.whl`
Install pywin32 system files by run `python.exe Scripts\pywin32_postinstall.py -install` from an elevated command prompt.
2017-01-24 17:51:12 +01:00
Finally, you'll need [miniupnpc](https://pypi.python.org/pypi/miniupnpc/1.9). Download the source and compile with MinGW by running `mingw32make.bat`. Then install the module by running `python setupmingw32.py install`.
## Installation
2017-01-21 17:13:55 +01:00
To install:
```
2017-01-21 17:13:55 +01:00
git clone https://github.com/lbryio/lbry.git
cd lbry
virtualenv lbry-venv
source lbry-venv/bin/activate
pip install -r requirements.txt
2017-01-24 17:51:12 +01:00
pip install --editable .
```
To start LBRY, run `lbrynet-daemon` in a terminal.
2017-01-21 17:13:55 +01:00
2017-01-24 17:51:12 +01:00
To verify your install, `which lbrynet-daemon` should return a path inside of the `lbry-venv` folder created by the `virtualenv` command.
2017-01-21 17:13:55 +01:00
## Making a Change
2017-01-21 17:17:05 +01:00
If you are not already inside the virtual environment, run:
```
source lbry-venv/bin/activate
```
Then run:
2017-01-21 17:13:55 +01:00
```
2017-01-24 17:51:12 +01:00
pip install --editable .
2017-01-21 17:13:55 +01:00
```
2017-01-21 17:17:05 +01:00
This will update `lbrynet-daemon` and other executables.