This guide will walk you through the process of building Bitsquare from source.
NOTE: For most users, building from source is not necessary. See the releases page, where you'll find installers for Windows, Linux and Mac OS X.
What follows is explained in detail in the sections below, but for those who know their way around Java, git and Maven, here are the instructions in a nutshell:
$ javac -version
javac 1.8.0_20 # must be 1.8.0_20 or better
$ git clone https://github.com/bitsquare/bitsquare.git
$ cd bitsquare
$ mvn package
When the build completes, you will find an executable jar: gui/target/shaded.jar
.
To run it use:
$ java -jar gui/target/shaded.jar
To build the binary needs a bit more preparation as we use UpdateFX for automatic updates. You can find more information in the build scripts under package.
The only prerequisite for building Bitsquare is installing the Java Development Kit (JDK), version 8u20 or better (as well as maven and git).
To check the version of Java you currently have installed:
$ javac -version
javac 1.8.0_20
If javac
is not found, or your version is anything less than 1.8.0_20
, then you'll need to download and install the latest JDK for your platform.
TIP: Here are instructions for installing the JDK via
apt
on Debian/Ubuntu systems.
The preferred approach is to clone the Bitsquare repository using git:
git clone https://github.com/bitsquare/bitsquare.git
However, if you're not familiar with git or it is otherwise inconvenient to use, you can also download and extract a zip file of the latest sources at https://github.com/bitsquare/bitsquare/archive/master.zip.
Bitsquare uses maven as a build system.
$ cd bitsquare
$ mvn package
When the build completes, you will find an executable jar: gui/target/shaded.jar
.
To run it use:
$ java -jar gui/target/shaded.jar
For developing the following program arguments are useful (regtest mode):
$ java -jar gui/target/shaded.jar --bitcoin.network=regtest --useLocalhost=true --node.port=2222 --devTest=true --app.name=Bitsquare-Regtest-Alice
If the instructions above don't work for you, please raise an issue. Thanks!