kv2

module
v0.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 18, 2025 License: BSD-3-Clause

README ΒΆ

πŸ” kv2

[!WARNING] kv2 is still v0. Breaking changes are expected.

kv2 is a versioned, encrypted, key-value secrets manager for the homelab. This module provides the server and client components, as well as the reference CLI implementation. The kv2 server is:

  • Simple: available as a single binary or Docker container. The only interface is a REST API.
  • Lightweight: the simplicity of the service allows it to run almost anywhere, such as free tier VMs on hyperscale providers.
  • Secure: secrets are encrypted at rest, and the server is designed to integrate with Tailscale for controlling API access.

While these traits make kv2 perfect for my homelab, it may not be suitable for production environments.

πŸ“š Documentation

The full documentation is available in the docs directory.

πŸš€ Quickstart

Alternatively, if you are just looking to move fast and break things:

docker run --rm --name kv2 -p 80:8080 -e KV2_DEV_MODE=true ghcr.io/hugginsio/kv2:latest

🀝🏻 Thanks


"Tailscale" is a registered trademark of Tailscale Inc. The kv2 project is not endorsed by, sponsored by, or affiliated with Tailscale Inc.

Directories ΒΆ

Path Synopsis
cmd
server command
internal
crypto/nocrypto
Package nocrypto provides a no-op implementation of the crypto interface for development mode.
Package nocrypto provides a no-op implementation of the crypto interface for development mode.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL