-
Notifications
You must be signed in to change notification settings - Fork 4
Setup Guide for Ubuntu Linux
18.1 Supported on Ubuntu versions: 16.04 LTS and newer (tested on Ubuntu 16.04 LTS and Ubuntu 18.04 LTS).
18.1.1 It should work on other Debian based distribution of similar age. Ubuntu 14.04 is unsupported.
18.1.2 NOTE: When you run dexbot on a linux vps with a non root user you must run the setup from a virtualenv tool, you cannot run the setup otherwise because you won't have write access to dist-packages.
See this helpful guide for installing and using a virtualenv with python3.
18.1.2.1 When running in a virtual environment using virtualenv tool or on a virtual private Server you may need to install PyQt5 manually. Type:
$ sudo apt-get install python3-pip
$ pip3 install --user pyqt5
$ sudo apt-get install python3-pyqt5
$ sudo apt-get install pyqt5-dev-tools
$ sudo apt-get install qttools5-dev-tools
18.1.2.2 DEXBot recommends using Ubuntu 18.04 to have all the necessary libraries for DEXBot pre-installed.
If you wish to use a different flavor of Linux you need to download python 3.6 directly from https://www.python.org/downloads/release/python-360/
18.2.1 Bring up a terminal with CTRL + Alt + T.
18.2.2 Copy and paste the following commands into the terminal one line at a time and press Enter. Don't copy the $-sign, as it just signifies that you run the command as a normal user - not superuser.
Installation steps for GUI:
$ sudo apt-get install gcc make libssl-dev python3-pip python3-dev git
$ git clone https://github.com/graphene-blockchain/DEXBot.git dexbot
$ cd dexbot
$ make install-user
Possible additional needed commands in case some packages are missing:
$ pip3 install --user pyqt5
$ sudo apt-get install python3-pyqt5
$ sudo apt-get install pyqt5-dev-tools
$ sudo apt-get install qttools5-dev-tools
$ sudo apt-get install -y software-properties-common
$ sudo add-apt-repository universe
$ pip install -r requirements.txt
18.3.1 If you just want the CLI version without graphics (which will work on more systems):
For Ubuntu 18.04 LTS:
$ sudo add-apt-repository universe
$ sudo apt-get install python3-pip libssl-dev
$ pip3 install pyyaml
$ pip3 install uptick
$ pip3 install tabulate
$ sudo apt-get install git
$ git clone https://github.com/graphene-blockchain/DEXBot.git dexbot
$ cd dexbot
$ pip3 install -r requirements.txt
$ pip3 install --user -e .
For other Ubuntu versions:
$ sudo apt-get install gcc make libssl-dev python3-pip python3-dev git
$ git clone https://github.com/graphene-blockchain/DEXBot.git dexbot
$ cd dexbot
$ pip3 install --user -e . (the dot included)
Possible additional needed commands in case some packages are missing:
$ pip3 install --user pyqt5
$ sudo apt-get install python3-pyqt5
$ sudo apt-get install pyqt5-dev-tools
$ sudo apt-get install qttools5-dev-tools
$ sudo apt-get install -y software-properties-common
$ sudo add-apt-repository universe
$ pip install -r requirements.txt
18.4.1 On some Ubuntu systems, it will complain about missing packages; you first need to make sure you have the universe repository. And also have the Requirements.txt installed. Here's how:
$ sudo apt-get install -y software-properties-common
$ sudo add-apt-repository universe
$ pip install -r requirements.txt
If this doesn't solve the missing packages issue, proceed to 18.4.2
18.4.2 NOTE: You don’t need to upgrade the system; the issue here is about the range of packages available, not how new/old the packages are.
18.4.3.1 Start by updating the package list using the following command:
$ sudo apt update
18.4.3.2 Use the following command to install pip for Python 3:
$ sudo apt install python3-pip
The above command will also install the dependencies required for building Python modules.
18.4.3.3 Once the installation is complete, verify the installation by checking the pip version:
$ pip3 --version
18.4.3.4 The version number may vary, but it should look something like this:
Output
pip 9.0.1 from /usr/lib/python3/dist-packages (python 3.6)
18.4.3.5 Sometimes when installing DEXBot v0.15.5 and above users will need to install the "alembic" module. Type:
$ python3 -m pip install alembic
18.5.1 To run with GUI Type the following command (without the $-sign) and press enter.
$ ~/.local/bin/dexbot-gui
18.5.1.1 To run with CLI Type the following command (without the $-sign) and press enter:
$ ~/.local/bin/dexbot-cli configure
and follow the setup.
18.5.1.2 To run a previously setup worker with cli, type:
$ ~/.local/bin/dexbot-cli run
18.5.2 The bot writes a log file in the same working directory. If you are running the GUI you can watch the output with: tail -f ~/.local/share/dexbot/dexbot.log (write in a separate command-line and press Enter)
18.5.3 A local API node can be configured in ~/.config/dexbot/config.yml.
18.5.4 You can run the gui.py file in the /DEXBot folder. Install lubuntu for a GUI.
18.5.5 Use your active "private key" (not your web password for Crypto-Bridge/OpenLedger/SparkDEX/GDEX etc) for the worker privkey. You can find it in the public/private key viewer by unlocking your bts account on a webwallet or downloaded Graphene client. See 43 seconds onwards of this video to see how to find and copy your active private key.
18.5.6 See the Graphene Active Private Key Guide here for finding your private active key in your Graphene wallet.
18.6.1 Assuming you are on master branch (When you use git to install DEXBot the master branch is used by default. If you're purely using Linux to install DEXBot you will be on master branch without having to do anything):
For (CLI) installation update:
cd ~/dexbot
git pull
pip3 install -r requirements.txt
pip3 install --user -e .
For (GUI) installation update:
$ cd ~/dexbot
$ git pull
$ make install-user
18.7.1.1 Download the latest release tar.gz file 18.7.1.2 Extract the file into your folder of choice
18.7.2.1 Double click either dexbot-cli or dexbot-gui executable
18.8.1 Remove the old version (no need to delete config and database files)
18.8.2 Repeat installation process
18.9.1 Have a look at common problems.