Local DB Plugin - Eliza

The Local DB plugin provides a simple, file-based database adapter for Eliza agents using JSON storage. No SQL engine, no migrations, no external dependencies.

Package: @elizaos/plugin-localdb

Category: Database

Overview

This plugin implements the elizaOS database adapter interface using JSON files stored on the local filesystem. It provides lightweight persistence suitable for single-agent setups, development, and environments where running a full database server is unnecessary. Data is written to disk as plain JSON, making it easy to inspect and back up.

Installation

bash

eliza plugins install localdb

Configuration

No environment variables or configuration required. The plugin works out of the box once installed.

When to Use

Single-agent setups — One agent running on a local machine
Development — Inspect stored data directly by reading JSON files
Lightweight deployments — No database server to configure or maintain
Backup-friendly — Copy the JSON files to back up all agent state

Comparison

Feature	Local DB	In-Memory DB
Persistence	JSON files on disk	None
Speed	Fast	Fastest
Dependencies	Filesystem	None
Data survives restart	Yes	No