Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time

Trustee Community

Check out the wiki for sequence diagram and more

Trustee Community is the code repository a community manager can fork to create a new patient community.

To create a new patient community, a manger will need these four things:

  • An account at DigtialOcean to pay for hosting the community members Trustees (patient-controlled health records),
  • An account at Stripe to collect credit card payments for Trustee subscriptions hosted by the community,
  • A domain name for the community,
  • A privacy policy describing the initial configuration of Trustee access policies and how subscribers can change the policies if they choose.# Getting Started


1. Gather all API keys for Magic, USPSTF, UMLS, DigitalOcean, and SendGrid

  • have these ready for the installer in step 4
  • details on getting API keys are in the section More on Additional API Services
  • assume you have a domain name ( and email address needed for LetsEncrypt SSL (

2. Create a DigitalOcean Droplet with the minimum parameters:

  • size: 's-1vcpu-1gb',
  • image: 'ubuntu-22-10-x64'

3. Login to the console (should be root user) and enter this command:

git clone -b deploy --single-branch
cd Trustee-Community

4. The first pass will install all dependencies. Logout and login to the droplet.

cd Trustee-Community

5. Open your browser to

More on Additional API Services

Magic instructions:

1. Set up an account for free by visiting Magic. Click on Start now.

2. Once you are in the dashboard, go to Magic Auth and click on New App. Enter the App Name (My App Powered by Trustee) and hit Create App.

3. Once you are in the home page for the app, scroll down to API Keys and copy the PUBISHABLE API KEY value. This API Key will be usee to interact with Magic's APIs

National Library of Medicine UMLS Terminology Services - this is to allow search queries for SNOMED CT LOINC, and RXNorm definitions.

1. Set up an account here

2. Edit your profile and click on Generate new API Key. Copy this API key.

US Preventive Services Task Force - this provides Care Opportunties guidance based on USPSTF guidelines

1. Visit this site for instructions


Trustee is based around Docker containers. This repository source code is for the Trustee core which is Next.JS based application and served by Node.JS. Deployment of individual Docker containers which includes the patient health record powered by NOSH specific to only one patient/user is demonstrated by this project.

The docker-compose.yml (template found in docker-compose.tmp under the docker directory) defines the specific containers that when working together, allow Trustee to be able to fully featured (e.g. a bundle). Below are the different containers and what they do:

1. Traefik - this is the router, specifying the ports and routing to the containers in the bundle

2. CouchDB - this is the NoSQL database that stores all documents

3. NOSH - this is the Node.js based server application

4. Watchtower - this service pulls and applies updates to all Docker Images in the bundle automatically without manager intervention

Developer API

Get all patients

GET /api/couchdb/patients/all

Get all rs requests

GET /api/couchdb/requests/all