Home

KV Manager Wiki

Welcome to the KV Manager documentation! This wiki provides guides for installation, deployment, usage, and troubleshooting.

🎯 Quick Links

• Try the Live Demo - See KV Manager in action
• GitHub Repository
• Release Announcement Article

📖 Documentation

Getting Started

• Installation - Set up KV Manager for local development
• Production Deployment - Deploy to Cloudflare Workers
• Docker Deployment - Run with Docker or Kubernetes
• Configuration - Environment variables and settings

Features & Usage

• Namespace Management - Create, delete, and manage namespaces
• Key Operations - CRUD operations for KV keys
• Metadata and Tags - Working with metadata and tags
• Search and Discovery - Finding keys across namespaces
• Bulk Operations - Batch processing for large operations
• Import and Export - Data migration and backups
• R2 Backup and Restore - Cloud backup to R2 storage
• Job History - Tracking and monitoring bulk operations
• Health Dashboard - At-a-glance operational status and health score
• Audit Logging - Operation history and compliance
• Webhooks - Event-driven HTTP notifications
• Threshold Monitoring - Hourly metrics polling and audit log integration

Technical Documentation

• Architecture - System design and components
• API Reference - Complete API documentation
• Database Schema - D1 database structure
• Progress Tracking - How async operations work
• Authentication - Cloudflare Access integration

Guides & Resources

• User Guide - Step-by-step usage instructions
• Migration Guide - Upgrading from older versions
• Troubleshooting - Common issues and solutions
• Security Best Practices - Hardening your deployment
• Contributing - How to contribute to the project
• Changelog - Release notes and version history

🚀 Quick Start

Local Development

Install dependencies:

npm install

Initialize D1 database:

npx wrangler d1 execute kv-manager-metadata-dev --local --file=worker/schema.sql

Start development servers (2 terminals):

Terminal 1 — Frontend:

npm run dev

Terminal 2 — Worker:

npx wrangler dev --config wrangler.dev.toml --local

Access at: http://localhost:5173

Docker Quick Start

docker pull writenotenow/kv-manager:latest

docker run -d \
  -p 8787:8787 \
  -e ACCOUNT_ID=your_account_id \
  -e API_KEY=your_api_token \
  -e TEAM_DOMAIN=https://yourteam.cloudflareaccess.com \
  -e POLICY_AUD=your_aud_tag \
  --name kv-manager \
  writenotenow/kv-manager:latest

Access at: http://localhost:8787

💡 What is KV Manager?

KV Manager is a modern, full-featured web application for managing Cloudflare Workers KV namespaces and keys. It provides:

• Intuitive UI - Beautiful, responsive interface built with React and Tailwind CSS
• Enterprise Auth - Cloudflare Access (Zero Trust) integration
• Dual Metadata - KV Native (1024 bytes) + D1 Custom (unlimited)
• Advanced Search - Cross-namespace search with tag filtering
• Bulk Operations - Process thousands of keys efficiently
• Scheduled Threshold Monitoring - Hourly metrics polling and audit log integration
• R2 Backups - Cloud-native backup and restore
• Job History - Complete audit trail with event timelines
• Dark Mode - System-aware theme support

📝 Version

Please refer to the GitHub Releases page for the current version and most recent updates.

🤝 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: admin@adamic.tech

📄 License

MIT License - see LICENSE for details