HarperDB Overview

HarperDB is a turn-key solution for the collection, distribution, and analysis of data throughout your organization. Projects that have historically taken months (or even years) of consulting, configuration, and custom development can be completed in days or weeks with HarperDB.

HarperDB provides unmatched flexibility, security, and value for just about every use case, and we do it all with a single installation that can run in the cloud, on-premise, and at the edge.

Learn more about HarperDB

HarperDB Studio

Every Installation of HarperDB can be administered online using HarperDB Studio. This web-based interface provides you the ability to set up new schemas and tables, configure users and roles, manage data replication, and purchase and deploy enterprise licenses.

  • Simplify Administration – handle all HarperDB administration tasks from one simple interface

HarperDB Studio

Built-In API

Reduce or eliminate complexity by using HarperDB’s built-in API. Create and manage not only the data you’re storing but all configuration and replication settings from a single endpoint that supports HTTP and HTTPS.

  • Reduce or Eliminate Middleware – speed up development and lower costs
  • Reduce Overhead, Increase Security – API requests are individually authenticated and self-closing

API Reference

Documentation and Support



Software Included

Package Version License
HarperDB 4.1.3 Restricted

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Deploy to DO

Creating an App using the API

In addition to creating a Droplet from the HarperDB 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB HarperDB Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "harperdb-18-04"}' \

Getting Started After Deploying HarperDB


HarperDB is a distributed database focused on making data management easy. HarperDB has an easy to use REST API, supports NoSQL and SQL including joins, and is easy to use. HarperDB leverages standard interfaces so that you can use the reporting and analysis tool that best meets your needs.

Getting Started

Deploying a HarperDB Droplet

  • When deploying your HarperDB Droplet, choose the Add Volume option and then select Manual Format & Mount.

Using Your HarperDB Droplet

Additional Information

  • A user account named harperdb is created when your Droplet is deployed. This account is used to run HarperDB, and does not have sudo privileges.
  • The password is randomly generated on creation. Credentials are stored in /root/.harperdb
  • The additional block storage volume attached to your Droplet is used to store the HarperDB databases. Logical Volume Manager is used to create a logical volume on this block storage volume. If needed, expand the block storage volume and use Logical Volume Manager to expand the logical volume. See our LVM Digital Ocean Docs
  • The Droplet uses Uncomplicated Firewall (ufw); the following ports are enabled 9925 HarperDB HTTP, 9926 HarperDB HTTPS, 9932 HarperDB Clustering, and 22 SSH.
  • It is recommended that you update HarperDB admin password.