Mac M1

Build and Run the Plutus Playground server and client

1 clone the right repository! not the ...plutus one, it needs to be the ...plutus-apps repo:

git clone https://github.com/input-output-hk/plutus-apps
2 goto folder
cd plutus-apps/
3 no checkout of commits needed, just use the master branch for now

4 build the server

nix-build -A plutus-playground.server
IMPORTANT: if there occurs a segfault, just build it again, it will work.

5 build the client

nix-build -A plutus-playground.client
same here, if there are errors during build, just call the command again.

6 start nix shell (takes some time)

nix-shell
7 goto server dir and start server (yes, with the GC thing in front)
cd plutus-playground-server
GC_DONT_GC=1 plutus-playground-server
sometimes the server will not start at first try. try again, second start should work!

8 wait until server is started! you will see something like this

plutus-playground-server: for development use only
[Info] Running: (Nothing,Webserver {_port = 8080, _maxInterpretationTime = 80s})
Initializing Context
Initializing Context
Warning: GITHUB_CLIENT_ID not set
Warning: GITHUB_CLIENT_SECRET not set
Warning: JWT_SIGNATURE not set
Interpreter ready
9 when server is started you can open a second nix-shell in another terminal
nix-shell
10 in the second terminal with nix-shell run
sudo npm install -g npm
11 goto client dir and start client (yes, with the GC thing in front)
cd plutus-playground-client
GC_DONT_GC=1 npm run start
12 wait until client has started and you see something like this
webpack compiled with 1 warning
ℹ 「wdm」: Compiled with warnings.
will take some time. same here as above: if there are errors be sure to try at least a second build!

if the client takes to long it could be that it runs in timeout which is default 80 seconds.

to prevent this and change the timeout to 150 seconds eg, you can start the server with an option like this:

GC_DONT_GC=1 plutus-playground-server -i 150s

both should work now, client with https cert security warning in your browser: https://localhost:8009/

wanna fix the certificate error in your browser? in plutus-playground-client folder do

nano webpack.config.js
and change the "https" flag from "true" to "false".

thats it, but not needed. the url from now on would be http://localhost:8009