Search…
Getting started
Set up your system to run the CAPE demo
You can find a video walkthrough of these instructions here. Note: If you have download and setup CAPE in a prior session, please go to Login to an Existing Wallet to access the CAPE wallet that you have already setup.
This guide describes how to run CAPE on a local computer (laptop or desktop) running Windows, MacOS or Linux. In particular we do not require or recommend setting up 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:
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

Next up, install and run docker and docker-compose:

  1. 1.
    On MacOS: brew install colima docker docker-compose; colima start
  2. 2.
    On Linux Ubuntu: sudo snap install docker
  3. 3.
    On Windows follow these steps instead:
    1. 1.
      Install WSL.
    2. 2.
    3. 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 here: https://docs.docker.com/get-docker/
Run the following command to obtain the docker-compose file you will run:
With docker running, run docker-compose in terminal in the same directory where the 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.
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.
Copy link