Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Important notice. Domain has recently been squatted with the help of a registrar that just cancelled the account (maybe because it was long time ago created by a Russian). They were even so kind to propose us to buy it back in their auction. As Universa's main idea is to fight any type of fraud and unequity we reject it and will just move out of their reach all our companies and domains. This will soon be reflected in the codebase.

This is the Universa network codebase (Java core), containing the node, the console client (uniclient) and the associated subsystems.

The latest documentation on Universa is available in Universa Knowledge Base at For a visual guide on the documentation topics, visit the Universa Development Map at

Docker image

If you are looking for the information on Universa Docker images, please consult the Knowledge Base page.

Build Dependencies

To build, you need to have the following installed:

  • JDK 8 or newer (being tested with OpenJDK 11).
  • Gradle.

To access the Github repository, you may need some Git client. The further examples assume you are using the command-line git client. To properly clone it from Github, you may need to create an SSH key pair, to register on Github site and to add your SSH public key on Github.

Build Dependencies: Debian/Ubuntu Linux

(Tested with Ubuntu 16.04 LTS, Debian Linux 9.3).

To build Universa, you need to setup Java (JDK) and Gradle (the Java build tool used in Universa).

Note: alternately, you may set up OpenJDK 11 using the standard packages for your Linux distribution. This is not covered here as usually it is much easier.

Setup Java: webupd8 approach (suggested)

sudo -s
echo "deb xenial main" | tee /etc/apt/sources.list.d/webupd8team-java.list
echo "deb-src xenial main" | tee -a /etc/apt/sources.list.d/webupd8team-java.list
apt-key adv --keyserver hkp:// --recv-keys EEA14886
apt-get update
apt-get install oracle-java8-installer oracle-java8-set-default binfmt-support

Setup Java: java-package approach (alternative)

First, install java-package (the tool that will help you to pack the Oracle JDK tarball into the .deb package).

sudo apt-get install -y java-package

Visit the Oracle JDK 8 site and download the tarball (.tar.gz) package for Linux x64 (assuming you run it on one). You will get a file like jdk-8u152-linux-x64.tar.gz (the title may vary, depending on the version).

Using the java-package framework, convert the tarball into the .deb package (replace the jdk-8u152-linux-x64.tar.gz with your specific name, if needed).

make-jpkg jdk-8u152-linux-x64.tar.gz

It will create a .deb package named accordingly. Install it (replace the oracle-java8-jdk_8u152_amd64.deb with your specific name, if needed).

sudo dpkg -i oracle-java8-jdk_8u152_amd64.deb

You may also need to configure your future Gradle environment to refer to the just-installed JDK:

mkdir -p ~/.gradle
cat <<EOT > ~/.gradle/

Setup Gradle

sudo apt-get install -y gradle

How to build Universa

Create a directory where the project will be placed, and, inside it, run the following commands:

git clone git:// ./

Then you can build it.

Universa node may be built either in multi-jar configuration (suggested),..

 gradle :universa_node:buildMultiJar -x test

... or as a “fat jar”:

gradle :universa_node:fatJar

Uniclient (CLI interface to Universa) is built as “fat jar” only:

gradle :uniclient:fatJar

To successfully compile it, you may need GNU Multiple Precision Arithmetic Library (“libgmp”) installed. See the details specific to your operating system regarding how it can be installed.


After building launch Universa components.

Launching the node, built in “multi-jar” configuration:

java -jar universa_node/build/output/uninode.jar

Launching the node, built in “fat jar” configuration:

java -jar universa_node/build/libs/uninode-all.jar

Launching uniclient:

java -jar uniclient/build/libs/uniclient.jar


To build Universa under Windows, you need to install the Oracle JDK and Gradle from the binary distributions, and use them similarly. You will need to pass an extra -Dfile.encoding=utf-8 option to gradle; so the build commands

gradle :universa_node:jar
gradle :uniclient:fatJar


gradle -Dfile.encoding=utf-8 :universa_node:fatJar
gradle -Dfile.encoding=utf-8 :uniclient:fatJar