3.9 KiB
description: Building Pantheon from source code
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
!!! note "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.