Plutus VM (Ubuntu Based)

Plutus Pioneer Program

Vagrant + VBox for plutus playground

Prerequisites

1. Obtain & Install Vagrant from the Official Source
2. Obtain & Install VirtualBox from the Official Source
3. Reboot

Installation

• Navigate to a directory of your choice and do

git clone https://github.com/edwint88/plutus-vm plutus-vm

• Navigate to inner-folder called vagrant.

cd plutus-vm/vagrant/

• In the Vagrantfile directory run & wait for provisioning to finish:

vagrant up

• When it finished provisioning, open TWO terminal windows and run in each (alternative run tmux in one terminal):

vagrant ssh

• In Terminal Window 1:

cd /home/vagrant/plutus/git/plutus
nix-shell
cd plutus-playground-client
plutus-playground-server -i 120s

• In Terminal Window 2:

cd /home/vagrant/plutus/git/plutus
nix-shell
cd plutus-playground-client
npm run start

• Go in your browser at https://192.168.5.21:8009 (if you changed the VM IP go to that IP)
• How to SSH-Remote from vscode: https://medium.com/@lopezgand/connect-visual-studio-code-with-vagrant-in-your-local-machine-24903fb4a9de

Update and recompile Plutus-playground for a running VM

Go to cd /home/vagrant/plutus/git/plutus => run git pull => run update /bin/bash ../updatePlutus.sh

Tips & Tricks

1. If you need ghc or cabal you can enter a folder with default.nix and run nix-shell over there and then change to your directory where you need to run cabal. E.g. cd /home/vagrant/plutus/git/plutus => nix-shell => cd ../plutus-pioneer-program/code/week1 => cabal build
2. If you want to use auto-complete function, then enter nix-shell as above and then run vim. (This doesn't work with vscode). You could open a Terminal window in vscode and run vim from there.