Mac OS

Build and Run the Plutus Playground server and client

1 - Now to install, clone the git repo first

[$] git clone https://github.com/input-output-hk/plutus-apps.git

2 - All the following builds should be executed while in the plutus directory

[$] cd plutus-apps

3 - Build the Plutus Playground Client / Server

[$] nix-build -A plutus-playground.client
[$] nix-build -A plutus-playground.server

4 - Build other plutus dependencies

[$] nix-build -A plutus-playground.generate-purescript
[$] nix-build -A plutus-playground.start-backend
[$] nix-build -A plutus-pab

5 - Go into nix-shell

[$] nix-shell

6 - inside of the nix-shell

[$] cd plutus-pab
[$] plutus-pab-generate-purs
[$] cd ../plutus-playground-server
[$] plutus-playground-generate-purs

7 - start the playground server

[$] plutus-playground-server

Great! All set.

8 - Now in a new terminal window:

[$] cd plutus-apps
[$] nix-shell
[$] cd plutus-playground-client

9 - Here we compile / build the frontend of the playground

[$] npm run start

We're done!

The playground should be up and running.

Open your finest browser and navigate to:

https://localhost:8009/

Cloned from Reddit

Go give u/RikAlexander karma!

Note:

On MacOS BigSur some users have reported that the building failed with an error like:

error: while setting up the build environment: getting attributes of path '/usr/lib/libSystem.B.dylib': No such file or directory

There are two solutions that are reported to solve this problem: - Change the nix build to an unstable (read: newer) build of nixpkgs.

[$] sudo nix-channel --add https://nixos.org/channels/nixpkgs-unstable unstable

• Disabling thesandbox and extra-sandbox-paths properties in the /etc/nix/nix.conf and ~/.config/nix/nix.conf files.

Note 2:

If anyone gets stuck because of this error:

"error: refusing to create Nix store volume ... boot volume is FileVault encrypted"

You should check out these links (Thank you u/call_me_coldass): https://github.com/digitallyinduced/ihp/issues/93#issuecomment-766332648 https://www.philipp.haussleiter.de/2020/04/fixing-nix-setup-on-macos-catalina/

Troubleshooting

nix-shell exits with segmentation fault

Error message:

[$] nix-shell
[1]    296 segmentation fault  nix-shell

Solutions: - Comment out the line withHoogle = false; in shell.nix before running nix-shell

#withHoogle = false;

haskell-language-server fails with segmentation fault / You can't get any Haskell editor-integration working

• Problem: running [$] haskell-language-server in one of the plutus-pioneer-program repos fails with a segmentation fault

  [$] cd plutus-pioneer-program/code/week01
  [$] haskell-language-server
  haskell-language-server version: 0.9.0.0 ...
  ...
  [INFO] Using interface files cache dir: ghcide
  [INFO] Making new HscEnv[plutus-pioneer-program-week01-0.1.0.0-inplace]
  Segmentation fault: 11
  

Solution: - Upgrade the plutus-apps repo to a later release (maybe master branch). Since haskell-language-server has version 0.9.0.0 (as you can see in the first line after execution) and this version is not ready for macOS Big Sur. Note This error probably occurs due to the linker changes introduced in macOS Big Sur, see

npm run start for the plutus-playground-client fails with modules not found

Problem: Server exits prematurely with compilation errors. Complaining about modules it could not find.

Solution: - Trigger rebuild of client: [$] cd plutus-playground-client [$] npm clean-install

- Try to start client: `[$] npm run start`
- If this is insufficient, try cleaning up the git repo and redo the previous steps
[$] git clean -xfd