Harper Getting Started

What it is: Batteries-included developer toolbox for Harper.

Why it matters: Get Harper running with monitoring in under a minute.

The bottom line: Everything works out of the box ✅

🚀 Quick Start

git clone https://github.com/yourusername/harper-getting-started.git
cd harper-getting-started/docker
docker-compose up -d

Harper: http://localhost:9925 (admin/HarperRocks!) Grafana: http://localhost:3000 (admin/HarperRocks!) 📊

What's Included

Docker environment with two modes:

• Single node - Development and testing
• 3-node cluster - Replication and HA testing

Key features:

• Zero configuration
• Auto-provisioned monitoring
• Persistent data volumes
• Health checks included

Requirements

• Docker & Docker Compose 2.0+
• 4GB RAM (8GB for cluster)
• Ports: 3000, 9925-9946

Deployment Options

Single Node

docker-compose --profile single up -d

Best for: Development, API testing, learning

Cluster (3 nodes)

docker-compose --profile cluster up -d

Best for: Replication testing, HA scenarios, performance testing

Documentation

• Docker Setup
• Usage Guide
• Data Formats

Use Cases

• Developers - Local development with monitoring
• DevOps - Test deployments and clustering
• Architects - Evaluate Harper capabilities
• QA - Consistent test environments
• Learning - Explore Harper features

Contributing

Contributions welcome:

• New deployment configurations
• Monitoring improvements
• Utility scripts
• Documentation

License

Apache 2.0 - See LICENSE

Resources

• Harper Docs
• Docker Hub
• Grafana