Setting up the Plutus Playground

This tutorial helps you to setup the Plutus Playground and matches the playground version that is used in the third iteration of the Plutus Pioneer Program.

Install Nix

  • Use the steps outlined on the official Nix page
  • Make sure Nix is installed correctly using nix --version

Edit the /etc/nix/nix.conf

Open the file with the editor of your choice and add the following lines to the file (create the file if it does not exists).

substituters =
trusted-public-keys =

Download the plutus-apps repository

git clone

Choose the version of the Plutus Playground

If you're following the Plutus Pioneer Program you will need to select the commit hash of the Plutus repository, as shown in the following table:

LectureIteration 3
Week 13746610e53654a1167aeb4c6294c6096d16b0502
Week 26aff97d596c9d59460aab5c65627b1c8c0a1528
Week 34edc082309c882736e9dec0132a3c936fe63b4ea
Week 4----------------------------------------
Week 54edc082309c882736e9dec0132a3c936fe63b4ea

Then select the commit hash using the command git checkout <commit-hash> (for example git checkout 3746610e53654a1167aeb4c6294c6096d16b0502 for the lecture of week 1 of the third iteration).

Open a nix shell and start the server

Open a nix-shell with the command nix-shell

cd plutus-playground-client

Start the server using plutus-playground-server

Open a new terminal and run the client

Open a new terminal, go to the plutus-apps repository and run nix-shell.

Go to the plutus-playground-client folder: cd plutus-playground-client.

Finally run the client using npm run start.

Open the Plutus Playground

Finally the Plutus Playground will be available in https://localhost:8009

© IOHK 2015 - 2022

Cardano Logo

Cardano is an open-source project.

Cardano is a software platform ONLY and does not conduct any independent diligence on, or substantive review of, any blockchain asset, digital currency, cryptocurrency or associated funds. You are fully and solely responsible for evaluating your investments, for determining whether you will exchange blockchain assets based on your own judgement, and for all your decisions as to whether to exchange blockchain assets with Cardano. In many cases, blockchain assets you exchange on the basis of your research may not increase in value, and may decrease in value. Similarly, blockchain assets you exchange on the basis of your research may fall or rise in value after your exchange.

Past performance is not indicative of future results. Any investment in blockchain assets involves the risk of loss of part or all of your investment. The value of the blockchain assets you exchange is subject to market and other investment risks