Build / Configure / Launch / Launcher / Troubleshooting

Tutorial: Installing DeepOnion v1.5.1 on Ubuntu/Debian

Build instructions from GitHub

Source: github.com/deeponion/deeponion

Click here for latest build instructions from GitHub as versions will update.​

The following are commands needed to build on Ubuntu/Debian from scratch.
It is verified with Ubuntu 16.04, 17.04 and has also been tested on 17.10.
For configuring and troubleshooting, scroll further down.​

First get the dependencies:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install build-essential libtool autotools-dev autoconf pkg-config libssl-dev libboost-all-dev
sudo apt-get install libqrencode-dev libminiupnpc-dev libevent-dev libcap-dev libseccomp-dev git
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:bitcoin/bitcoin
sudo apt-get update
sudo apt-get install libdb4.8-dev libdb4.8++-dev

To build GUI version do this:

sudo apt-get install libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler

Then get deeponion source from github:

git clone --recursive https://github.com/deeponion/deeponion.git

Build with autotools:

cd deeponion
./autogen.sh
./configure --with-gui=qt5 (if you want to build daemon, use --without-gui)
make

If upgrading your wallet:

Before launching v1.5.1 you should backup your current wallet as well as your private key (if you haven't already). Either go to your deeponion folder and copy your wallet.dat and private_key files to a backup folder or enter the following commands into terminal to do this for you:

mkdir -p ~/.DeepOnion/backup
cp ~/.DeepOnion/wallet.dat ~/.DeepOnion/backup
cp ~/.DeepOnion/tor/onion/private_key ~/.DeepOnion/backup

Launching DeepOnion​

Don't do this in root:

~/deeponion/src/qt/DeepOnion-qt

If file isn't executable:

cd ~/deeponion/src/qt/
chmod +x DeepOnion-qt
./DeepOnion-qt

Configuring the wallet

Download DeepOnion.txt (with latest nodes)

Then rename it to DeepOnion.conf and place it in the .DeepOnion directory (not deeponion), or enter the commands below:

wget https://deeponion.org/community/attachments/deeponion-txt.110023/?temp_hash=d2713aed0116db7e696604c86d567bd4
mv ~/Downloads/DeepOnion.text ~/.DeepOnion/DeepOnion.conf

Or you can download the official version with less nodes or other alternatives with more. Some relevant options are testnet=0, staking=1, listen=1 and server=1. Don't forget to set a rpcuser and rpcpassword, change it if you feel it's necessary.

Create Desktop Launcher​

Download desktop icon image:

cd ~/deeponion
wget https://i.imgur.com/dH9zLb3.png

Create desktop config file:

sudo leafpad /usr/share/applications/deeponion.desktop

Input data while changing $USER:

[Desktop Entry]
Type=Application
Exec=/home/$USER/deeponion/src/qt/DeepOnion-qt
Icon=/home/$USER/.DeepOnion/deeponion.png
Name=DeepOnion v1.5
GenericName=DeepOnion Wallet
Categories=Internet; Tor

Save and close file, run update:

sudo update-desktop-database

Troubleshooting​

For Debian 9 Stretch (only)

You'll need to install Open SSL 1.0 as a dependency, as Stretch comes with version 1.1. To do this, you can add Jessie Backports as a repository and install version 1.0. If you try removing 1.1 you'll risk breaking your system as there's a lot of programs that depend on it.

sudo nano /etc/apt/sources.list

Add this line to your sources list:


deb http://ftp.debian.org/debian jessie-backports main

Ctrl + X followed by Y + Enter to save file, then:

sudo apt update
sudo apt install libssl1.0 libssl1.0-dev

Configuration problem with Berkeley headers (16.04+):

If during configuration you have problems with Berekely 4.8 headers, then try installing libdb4.8-dev and libdb4.8++-dev again. If for some reason installing these was unsuccessful, for example it conflicts with another libdb package, then purge this version and try again. The following will also purge some other build libraries, but will re-install them after.

These are the commands if you have libdb5.3 libraries installed instead:

sudo apt --purge remove libdb5.3-dev libdb5.3++-dev
sudo apt autoremove && sudo apt clean
sudo apt-get install libdb4.8-dev libdb4.8++-dev

If this doesn't work, then you'll need to build Berkeley from source:

cd ~
wget 'http://download.oracle.com/berkeley-db/db-4.8.30.NC.tar.gz'
tar -xzvf db-4.8.30.NC.tar.gz
cd db-4.8.30.NC/build_unix/
../dist/configure --enable-cxx
sudo make install

Libboost libraries not found during configuration or when booting

For problems in Ubuntu 17.04 and 17.10, these are the required symlinks:

sudo ln -s /usr/lib/x86_64-linux-gnu/libboost_system.so.1.62.0 /usr/lib/x86_64-linux-gnu/libboost_system.so.1.58.0
sudo ln -s /usr/lib/x86_64-linux-gnu/libboost_filesystem.so.1.62.0 /usr/lib/x86_64-linux-gnu/libboost_filesystem.so.1.58.0
sudo ln -s /usr/lib/x86_64-linux-gnu/libboost_program_options.so.1.62.0 /usr/lib/x86_64-linux-gnu/libboost_program_options.so.1.58.0
sudo ln -s /usr/lib/x86_64-linux-gnu/libboost_thread.so.1.62.0 /usr/lib/x86_64-linux-gnu/libboost_thread.so.1.58.0
sudo ln -s /usr/lib/x86_64-linux-gnu/libevent-2.1.so.6 /usr/lib/x86_64-linux-gnu/libevent-2.0.so.5

To remove symlinks you just created if they didn't work:

sudo rm /usr/lib/x86_64-linux-gnu/libboost_system.so.1.58.0
sudo rm /usr/lib/x86_64-linux-gnu/libboost_filesystem.so.1.58.0
sudo rm /usr/lib/x86_64-linux-gnu/libboost_program_options.so.1.58.0
sudo rm /usr/lib/x86_64-linux-gnu/libboost_thread.so.1.58.0
sudo rm /usr/lib/x86_64-linux-gnu/libevent-2.0.so.5

To clean the deeponion directory in order to reconfigure and install:

cd ~/deeponion/
sudo make clean

You've managed to break your libboost libraries

Then you need to purge them properly to re-install them:

sudo apt --purge remove libboost1.62-all-dev libboost1.62 libboost1.62-dev
sudo apt autoremove -y && sudo clean

Then check file sysem in /usr/lib/x86_64-linux-gnu for libboost files before re-installing:

sudo apt install libboost-dev libboost-all-dev

Oops! You've executed the DeepOnion-qt file in root

If you by mistake execute the ./DeepOnion-qt file with root priviledges, then don't worry it's recoverable. To change file permissions back to user with the X's replaced by the relevant numbers and $USER changed to your username. Continue changing file permissions if the problem persists:

sudo chown $USER -R ~/.DeepOnion/txleveldb/CURRENT
sudo chown $USER -R ~/.DeepOnion/txleveldb/MANIFEST-XXXXXX

If you get stuck, then feel free to ask.
If in doubt, check debug.log for a clue.

Click here for forum thread or here to sign up.

Related tutorials & references:
01/18: Running DeepOnion On Raspberry Pi 3
10/17: Build The Qt Wallet On Ubuntu
10/17: Install DeepOnion V1.2 On Ubuntu 17.04
09/17: Install DeepOnion On Ubuntu [*nix]
08/17: DeepOnion Running Headless On Your Linux Box​