Docker Compose Plutus Playground Setup (outdated)

Credits

Prebuilt or self built?

Within https://github.com/maccam912/ppp are several docker-compose files. The files ending with "weekXX" point to pre-built docker images if you would rather download a large image than have docker build it by itself.

For example, after cloning maccam912/ppp, to start a playground that works for week03, run

docker-compose --file docker-compose-week03.yml up

and go to https://localhost:8009 after it starts.

To build the images yourself, the instructions are below:

Prerequisites

Docker or Podman
docker-compose or podman-compose
A host system with at least: a. 8 GB memory b. 50 GB disk

note: I will use docker here, but podman can be used in every instance you see docker, while podman-compose can be used instead of docker-compose. I use Fedora 33 where I can just run sudo dnf install podman podman-compose and be ready to rock n' roll.

Installation

Navigate to a directory of your choice and do

git clone https://github.com/maccam912/ppp

Navigate the new ppp folder

cd ppp

use docker-compose to build the images from the Dockerfiles

docker-compose build

note: this step takes a long time, and uses up 50 GB or so. Let it run to completion.

When docker-compose is done, start up the playground!

docker-compose up

You should now be able to connect to https://localhost:8009 (Note the S on HTTPS, this uses a self-signed certificate!) and after accepting the warning, get to a playground!

Tips & Tricks

I am running on Hetzner Cloud for a cheap 8 GB RAM instance. After the initial docker-compose build I made a snapshot I can restore from to shut down the instance and save money when I don't need the playground.