Setting up CAPE

Set up your system to run the CAPE demo

If you have downloaded and setup CAPE in a prior session, jump to Login to an Existing Wallet to access the CAPE wallet that you have already set up.

This guide describes how to run CAPE on a local computer (laptop or desktop) running Windows, MacOS, or Linux. We do not require or recommend using a VPS to run CAPE.

Running the CAPE demo UI requires docker and docker-compose. Docker is used to safely run the CAPE container, which serves the UI locally and manages wallet functionality.

To begin, open a terminal.

If you don't have docker and docker-compose, then run the following commands:

1. For Mac users, install Homebrew:

If you are on MacOS and don’t have Homebrew, install Homebrew first:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Note: If you have not used Homebrew before or are new to Terminal, you may need to install developer tools through the command: xcode-select --install

2. Next, install docker and docker-compose:

1. On MacOS: brew install colima docker docker-compose; colima start

2. On Linux Ubuntu: sudo snap install docker

3. On Windows:

   1. Install WSL.

   2. Install Docker Desktop.

   3. Run all the commands below in a WSL shell. To start a WSL shell run wsl in a PowerShell prompt.

You can also download Docker on the official website.

3. Run the following command to obtain the docker-compose file that we will use:

curl https://www.espressosys.com/cape/docker-compose.yaml --output docker-compose.yaml

4. With docker running, run docker-compose in your terminal, in the same directory where the docker-compose.yaml file was downloaded. To avoid setup issues, please run docker-compose, not docker compose.

If you have interacted with the CAPE UI before, first you should run the following command. CAUTION: this command will delete all your local containers!

docker-compose down -v

Run the following commands:

docker-compose pull

docker-compose up

You should see the following screen in your terminal when the wallet is running after you run docker-compose up.

5. Open a browser (Google Chrome is preferred) and go to localhost in the address bar. Since MetaMask is used to interact with Ethereum, Safari is not supported.