Wanderland Database Locations

Reference for all SQLite and other databases used by Wanderland services.

Oculus Databases

Database	Path	Purpose
Fence Index	~/.local/share/oculus/.cache/fence-index/fence-index.db	Code fence metadata, labels, node summaries
Observer Index	~/.local/share/oculus/.cache/fence-index/observer-index.db	File watcher state
Legacy JSON	~/.local/share/oculus/.cache/fence-index/fence-index.json	Old JSON format (deprecated)

Stuffy Databases

Database	Path	Purpose
TBD

Service Logs

Not databases but often needed alongside:

Service	Log Path
CCP-managed	/Users/graemefawcett/working/wanderland/logs/
Alternative	/Users/graemefawcett/org/logs/

Environment Variables

• OCULUS_STORAGE_DIR - Base storage directory (default: ~/.local/share/oculus)
• FENCE_INDEX_BACKEND - Backend type: sqlite (default) or dynamodb
• FENCE_INDEX_TABLE - DynamoDB table name (if using DynamoDB)

Notes

• Fence index uses WAL mode for concurrent reads
• Database files include -shm and -wal companions when active
• Run oculus reindex to rebuild fence index from scratch

Provenance

Document

• Status: 🔴 Unverified

Changelog

• 2026-01-26 04:08: Node created by mcp - Documenting database locations to stop losing them

North

slots:
- slug: wanderland-clients
  context:
  - Database reference under client infrastructure