Skip to content

ShellGuardThe Sovereign Secrets Vault

Zero-Knowledge password & secrets vault with autonomous AI agent key delegation, per-row metadata encryption, and bioluminescent defense.

ShellGuard Logo

Explore the Documentation ​


System Architecture ​


3-Step Rapid Onboarding ​

1

1. Configure & Generate Keys

Generate your master database encryption key and SuperLobster admin token:

bash
# Generate 256-bit DB Encryption Key (Layer 2 & 3)
openssl rand -base64 32

# Generate secure SuperLobster Admin Token
openssl rand -hex 24

Create docker-compose.yml in your deployment directory:

yaml
services:
  shellguard:
    image: ghcr.io/clawstackstudios/shellguard:latest
    container_name: shellguard
    restart: unless-stopped
    ports:
      - "6464:6464"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production
      - PORT=6464
      - DATA_DIR=/app/data
      - DB_ENCRYPTION_KEY=YOUR_GENERATED_BASE64_KEY
      - ADMIN_TOKEN=YOUR_GENERATED_ADMIN_TOKEN
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://localhost:6464/api/health"]
      interval: 15s
      timeout: 10s
      retries: 5
      start_period: 15s
2

2. Start & Verify the Container

Launch the container stack in detached mode and verify database connectivity:

bash
# Launch the container stack
docker compose up -d --wait

# Confirm system health
curl http://[IP-ADDRESS]:6464/api/health
3

3. Launch Vault & Molt Your Identity

Open http://[IP-ADDRESS]:6464 in your web browser:

  1. Molt Identity Key: Generate your sovereign 67-character hu- master key and download your recovery identity JSON. There are no central passwords, reset emails, or account recovery links.
  2. Lock Your Pearls: Store passwords, TOTP authenticators, SSH keys, attachments, and custom fields in The Grotto.
  3. Spawn AI Agents: Issue scoped, revocable lb- LobsterKeys in Settings → Agent Keys for autonomous AI coding agents.

Sovereign Zero-Knowledge Secrets Vault. Released under AGPL-3.0. • Privacy Policy