Build / Configure / Launch / Launcher / Troubleshooting
Build instructions from GitHub
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:
mkdir -p ~/.DeepOnion/backup cp ~/.DeepOnion/wallet.dat ~/.DeepOnion/backup cp ~/.DeepOnion/tor/onion/private_key ~/.DeepOnion/backup
Don’t do this in root:
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, 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, 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/wG4o5fB.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:
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 commands 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 and re-install:
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.