Mac Setup Guide

The purpose of this guide is to explain how to use the transmute cli, framework and platform on macOS for decentralized application development.

If you encounter any problems following this guide, please open an issue.

Getting Started

First we need to install some global dependencies, such as minikube. We provide a bootstrap script to automate this process, you should review the script before running it:

$ bash <(curl -Ls https://git.io/transmute_bootstrap)

Once the bootstrap is complete, you will have the transmute cli installed globally.

To provision a minikube cluster locally:

$ transmute k8s provision-minikube macOS-cluster --vmdriver virtualbox 

Next, we will install some microservices in the cluster, ganache for ethereum development, and ipfs for storage. We will configure access to them through kong, an api gateway:

$ transmute k8s init macOS-cluster

Once this completes, you will have a ~/.transmute directory, which contains a dashboard app that is preconfigured to use your local cluster.

$ cd ~/.transmute/git/transmute/packages/transmute-dashboard
$ npm i
$ TRANSMUTE_ENV='minikube' npm run truffle:migrate

Edit ./src/transmute-config/index.js to const TRANSMUTE_ENV = process.env.TRANSMUTE_ENV || 'minikube';

Start the app locally:

$ npm run start

Click the E-Signer Demo.