Haven Start9 Wrapper

Start9 Server package for Haven - a self-sovereign Nostr relay suite with Blossom media server.

About

This is a wrapper repository for packaging Haven for Start9 Server. The Haven application itself is included as a git submodule.

Repository Structure

haven-start9-wrapper/
├── haven/                    # Haven source (submodule)
├── Dockerfile                # Container definition
├── docker_entrypoint.sh      # Startup script
├── manifest.yaml             # Start9 package manifest
├── instructions.md           # User instructions
├── icon.png                  # Package icon
├── assets/
│   └── compat/               # Config/Properties scripts
├── docs/                     # Implementation documentation
└── Makefile                  # Build automation

Features

📊 Database Dashboard (New!)

• Web Interface: View all stored Nostr events via the LAUNCH UI
• Statistics: See event counts by kind and database
• Event Inspection: Click any kind to view raw JSON data
• Databases: Separate views for private, chat, outbox, and inbox relays

Access at: http://<your-onion-address>.local/dashboard

See: Database Dashboard Documentation

🔒 Haven Relay Suite

• Outbox Relay: Your public notes and content
• Inbox Relay: Receive messages from your web of trust
• Private Relay: Personal encrypted storage
• Chat Relay: Community conversations with WoT protection

🌸 Blossom Media Server

• Store images, videos, and files
• SHA-256 based content addressing
• Integrated with your Nostr identity

🚧 Upcoming Features (v1.3.0)

• ☁️ Cloud Backups: Automatic database backups to S3-compatible storage (Coming in v1.3.0)

🔐 Privacy & Security

Tor-Only Operation

Haven on Start9 operates exclusively over Tor for maximum privacy and security.

What This Means:

• No Clearnet Access: Haven is only accessible via .onion addresses
• Complete Privacy: Your relay location and IP address are protected
• Censorship Resistance: Tor network provides resistance to blocking and surveillance
• Encrypted by Default: All connections are encrypted through the Tor network

Accessing Your Haven Relay:

From Nostr Clients: Most modern Nostr clients support Tor connections:

• Android: Use Amethyst with Orbot (Tor proxy)
• iOS: Use Damus with Orbot iOS
• Desktop: Use nostrudel, Coracle, or any client with Tor support
• Web: Access through Tor Browser

Your Relay URLs: After installation, you'll receive .onion addresses for each relay:

ws://your-address.onion/private
ws://your-address.onion/chat
ws://your-address.onion/inbox
ws://your-address.onion

Blossom Media Server:

http://your-address.onion/

Client Configuration:

1. Enable Tor on your device (Orbot for mobile, Tor Browser for desktop)
2. Configure your Nostr client to use Tor proxy (usually SOCKS5 on 127.0.0.1:9050)
3. Add your Haven relay using the .onion address from Start9 Properties
4. Authenticate using NIP-42 (your client will handle this automatically)

Why Tor-Only?

• Self-Sovereignty: True ownership of your data without exposing your location
• Privacy-First: No metadata leakage about your relay's physical location
• Security: Protection against DDoS attacks and targeted harassment
• Perfect for Personal Relays: Your relay serves you and your web of trust, not the entire world

Trade-offs:

• Slower connections: Tor adds latency (typically 1-3 seconds)
• Client compatibility: Requires Tor-capable Nostr clients
• Initial setup: Need to configure Tor proxy on your devices

For most personal relay use cases, the privacy benefits far outweigh these minor inconveniences.

Documentation

• 📚 Documentation Index
• 📊 Database Dashboard ⭐ NEW
• 🧪 Dashboard Testing Guide
• 📋 Implementation Plan
• 📐 Technical Specification
• ✅ Implementation Checklist
• 🚀 Quick Start Guide
• ❓ FAQ

Quick Start

# Clone with submodules
git clone --recurse-submodules https://github.com/higedamc/haven-start9-wrapper.git
cd haven-start9-wrapper

# Install dependencies
./prepare.sh

# Build package
make

# Verify
make verify

🔢 Version Management

自動バージョンアップスクリプトを使用できます：

# パッチバージョンアップ (1.1.6 → 1.1.7)
make bump-patch

# マイナーバージョンアップ (1.1.6 → 1.2.0)
make bump-minor

# メジャーバージョンアップ (1.1.6 → 2.0.0)
make bump-major

# インタラクティブモード（推奨）
make bump-version

# 現在のバージョン確認
make version-check

📖 詳細: BUMP-VERSION-QUICKSTART.md

## Installation on Start9

```bash
# Option 1: Sideload
# Start9 UI → System → Sideload Service → Upload haven.s9pk

# Option 2: CLI
start-cli package install haven.s9pk

Development

See Quick Start Guide for detailed development setup.

Contributing

Contributions are welcome! Please read our Contributing Guide.

License

MIT License - See LICENSE

Links

• Haven GitHub
• Start9 Documentation
• Nostr Protocol
• Blossom Specification

Support

• GitHub Issues: https://github.com/higedamc/haven-start9-wrapper/issues
• Nostr: @npub16lrdq99ng2q4hg5ufre5f8j0qpealp8544vq4ctn2wqyrf4tk6uqn8mfeq