Skip to main content
Prerequisites: Please see Environment before proceeding.
Follow these steps to install and run our tutorials on your operating system:

​
Download and Install

Step 1: Install Locksmith: Locksmith is our KERI identity wallet and secure web proxy. We currently only have an installable version for macOS (arm64) PCs. To use any other operating system, you can download our Python Wheel and install as described below (Other native installers will be available shortly.).
  • macOS
  • Windows
  • Python
Shell
curl -s -L -o locksmith.dmg https://healthkeri-deployment.sfo3.digitaloceanspaces.com/locksmith/v0.0.1/MacOS/Locksmith.dmg
Or you can download Locksmith directly.Locate locksmith.dmg in Finder, double click and drag the Locksmith Icon into Applications folder.
Locksmith
Step 2: Clone the healthKERI rack-docker repository: 
git clone https://github.com/healthKERI/rack-docker.git
cd rack-docker
Note: Please see this Guide for using GitHub Desktop instead of the command line.

​
Launching Locksmith

If you downloaded one of our native installers for Locksmith please use your Operating System to find and launch the application. If you installed the Python wheel in a virtual machine, you can launch Locksmith with the following command: 
source ${PATH_TO_VENV}/bin/activate
lockmsith
Locksmith will attempt to create database files in one of two directories. If you have a directory named /usr/local/var/keri and the current user has write access to that directory it will create all database files and keystores at that location. Otherwise, it will create and use a directory named .keri in the current user’s home directory. If you want to back up your KERI identity information and your keystore, you can back up which ever of these two directories is created on your device. For more information see the KERI Python Reference Implementation.