Installation from Binaries

Learn how to use our prepackaged binaries to install Plasma quickly and easily.

Sections in this article


The fastest way to start using Plasma is to install one of our prepackaged binaries. We deploy every tagged build to Bintray, a hosted repository management service that’s compatible with any Linux distribution that supports Debian packages.

We sign every build with our PGP key, so in order to get started you’ll need to register our public key with your package manager. To do so in Ubuntu, run the following command:

$ sudo apt-key adv --keyserver --recv-keys 21052518

You should receive output that looks like this:

Executing: /tmp/apt-key-gpghome.MZuO4hoFiT/ --keyserver --recv-keys 21052518
gpg: key 23D7FC0021052518: public key "Kyokan, LLC OSS Signing Key <>" imported
gpg: Total number processed: 1
gpg:               imported: 1

Next, you’ll need to add our Debian repository to your list of apt sources. Run this command to do so:

$ echo "deb any main" | sudo tee -a /etc/apt/sources.list

Then run sudo apt-get update followed by sudo apt-get install plasma.

If you’re running a validator node, installation is now complete and you can move on to Configuration. If you’re running your own root node, read on - you still need to deploy the Plasma smart contract.

Deploying Plasma.sol

Plasma.sol is the smart contract responsible for processing deposits, exits, and storing the Merkle root of every block. If you’re running your own root node, you’ll need to deploy it prior to being able to use Plasma.

To deploy Plasma.sol, you’ll need to install Truffle. To do so, you’ll need Node and NPM, so make sure to install those if you haven’t already. Then, run the following commands:

$ npm install -g truffle # if you haven't installed truffle
$ cd contracts/ # change your working directory to the contracts dir
$ PRIVATE_KEY='<your private key, in hex>' HOST='<your Ethereum node>' trufle migrate --network <network name>

We’ve configured our Truffle config to take in your private key and Ethereum host from environment variables. We used the command above to deploy Plasma.sol to Rinkeby, so the gas amounts shouldn’t need to be changed.

As of this writing, deploying Plasma.sol costs around three million gas.

Next Steps

Now, you’re ready to configure your Plasma node.