Skip to content

Commit

Permalink
Merge pull request #8 from maccam912/main
Browse files Browse the repository at this point in the history
Added my Docker Compose setup instructions
  • Loading branch information
nstankov-bg committed Apr 13, 2021
2 parents 9f54ddf + 15787bf commit ef5fe68
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 0 deletions.
1 change: 1 addition & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# Summary

* [Vagrant (VM)](/docs/setup/Vagrant.md)
* [Docker Compose](/docs/setup/DockerCompose.md)
* [Windows WSL2](/docs/setup/WindowsWSL.md)
* [Ubuntu](/docs/setup/Ubuntu.md)
* [MacOS](/docs/setup/MacOS.md)
Expand Down
47 changes: 47 additions & 0 deletions docs/setup/DockerCompose.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Docker Compose Plutus Playground Setup

## Prerequisites

1. Docker or Podman
2. docker-compose or podman-compose
3. 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

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

* Navigate the new `ppp` folder

```ssh
cd ppp
```

* use `docker-compose` to build the images from the Dockerfiles

```ssh
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!

```ssh
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.

0 comments on commit ef5fe68

Please sign in to comment.