Features • Quick Start • Docs • Contributing

---

Horsync combines a centralized SaaS control plane (Hub) with direct peer-to-peer block exchange between client nodes, featuring client-side encryption, automated metadata stripping, and cross-platform background agents.

---

Features

• Hybrid Architecture — Central Hub + direct P2P transfers between nodes
• Zero-Knowledge Encryption — AES-GCM 256-bit with PBKDF2 key derivation
• Metadata Stripping — EXIF removal from images, XMP stripping from PDFs/Office docs
• P2P Mesh Discovery — UDP multicast (port 21027) for automatic LAN peer discovery
• Secure Transfers — TLS 1.2+ encrypted TCP (port 22000) with strict approval mode
• Background Agent — Cross-platform sync agent (Windows, Linux, macOS)
• Chunked Uploads — Resumable, integrity-verified with SHA-256 validation
• Bandwidth Governance — Token-bucket rate limiting
• Automation Rules — Configurable policies for encryption, metadata wiping, archival

---

Quick Start

Prerequisites

Go 1.22+, Node.js 18+, Docker Desktop (for PostgreSQL).

Production (Docker Compose - Recommended)

docker compose up -d --build

On Windows, you can simply run:

run_production.bat

Then open http://localhost:3001.

Development Mode (Hot Reload)

On Windows:

run_mvp.bat

Or manually:

docker compose up -d postgres
cp .env.example .env
cd frontend && npm install && cd ..
go build -o bin/horsync.exe ./cmd/horsync
DATABASE_URL="postgres://horsync:horsync123@localhost:5433/horsync?sslmode=disable" bin/horsync.exe
# In another terminal:
cd frontend && npm run dev

Then open http://localhost:3000.

Default Login
Email	admin@horsync.local
Password	admin12345

---

Tests

go test ./... -v -race -count=1
cd frontend && npx tsc --noEmit && npm run build

---

Documentation

• Contributing
• Frontend

---

Contributing

Contributions welcome! See CONTRIBUTING.md.

---

License

MIT License — see LICENSE.

---

_{Built by Yavuzlar}

🌐 Website • 🐦 X/Twitter • 💼 LinkedIn • 📸 Instagram • ✉️ Email