Skip to content
You are reading Pantheon development version documentation and some displayed features may not be available in the stable release. You can switch to stable version using the version box at screen bottom.

Build from Source

Prerequisites

Important

Pantheon requires Java 11+ to compile; earlier versions are not supported.

Running Locally

Running On Virtual Machine

Installation on Linux / Unix / Mac OS X

Clone the Pantheon Repository

Clone the PegaSysEng/pantheon repo to your home directory (/home/<user>):

git clone --recursive https://github.com/PegaSysEng/pantheon.git

Build Pantheon

After cloning, go to the pantheon directory.

Build Pantheon with the Gradle wrapper gradlew, omitting tests as follows:

./gradlew build -x test

Go to the distribution directory:

cd build/distributions/

Expand the distribution archive:

tar -xzf pantheon-<version>.tar.gz

Move to the expanded folder and display the Pantheon help to confirm installation.

cd pantheon-<version>/
bin/pantheon --help

Linux Open File Limit

If synchronizing to MainNet on Linux or other chains with large data requirements, increase the maximum number of open files allowed using ulimit. If the open files limit is not high enough, a Too many open files RocksDB exception occurs.

Continue with Starting Pantheon.

Installation on Windows

Note

Pantheon is currently supported only on 64-bit versions of Windows, and requires a 64-bit version of JDK/JRE. We recommend that you also remove any 32-bit JDK/JRE installations.

Install Pantheon

In Git bash, go to your working directory for repositories. Clone the PegaSysEng/pantheon repo into this directory:

git clone --recursive https://github.com/PegaSysEng/pantheon

Build Pantheon

Go to the pantheon directory:

cd pantheon

Open a Windows command prompt. Build Pantheon with the Gradle wrapper gradlew, omitting tests as follows:

.\gradlew build -x test

Note

To run gradlew, you must have the JAVA_HOME system variable set to the Java installation directory. For example: JAVA_HOME = C:\Program Files\Java\jdk1.8.0_181.

Go to the distribution directory:

cd build\distributions

Expand the distribution archive:

tar -xzf pantheon-<version>.tar.gz

Move to the expanded folder and display the Pantheon help to confirm installation.

cd pantheon-<version>
bin\pantheon --help

Continue with Starting Pantheon.

Installation on VM

You can run Pantheon on a virtual machine (VM) on a cloud service such as AWS or Azure, or locally using a VM manager such as VirtualBox.

If you set up your own VM locally using a VM manager such as VirtualBox, there are a few considerations:

  • Make sure that Intel Virtualization Technology (VTx) and Virtualization Technology for Directed I/O (VT-d) are enabled in BIOS settings.

  • On Windows, you might need to disable Hyper-V in the Windows Feature list.

It is recommended that you create a VM with the following attributes:

  • Memory Size: Set to 4096 (recommended)

  • Create a virtual hard disk with at least 10 GB; 20 GB is recommended

  • Virtual hard disk file type: VDI (if you need to share it with other apps, use VHD)

  • (Optional) You can create a shared directory in order to copy block files or genesis files from the host computer to the VM. For details on how to create a shared directory, see “Share Folders” in Install Ubuntu on Oracle VirtualBox.

Questions or feedback? You can discuss issues and obtain free support on Pantheon Gitter channel.
For paid professional support by PegaSys, contact us at [email protected]