> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentfront.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Storage Overview
> Persist embeddings between restarts with storage adapters
Learn how to persist embeddings between restarts using storage adapters.
By default, VectoriaDB stores embeddings in memory. Use a storage adapter to persist them between server restarts.
## Storage Adapters
| Adapter | Use Case | Persistence |
| ---------------------- | ------------------------ | -------------- |
| `MemoryStorageAdapter` | Development, testing | None (default) |
| `FileStorageAdapter` | Single-server deployment | Local disk |
| `RedisStorageAdapter` | Multi-pod deployment | Shared cache |
## Quick Start
```ts title="src/storage-quickstart.ts" theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
import { VectoriaDB, FileStorageAdapter, SerializationUtils } from 'vectoriadb';
const documents = collectToolDocuments();
const toolIndex = new VectoriaDB({
storageAdapter: new FileStorageAdapter({
cacheDir: './.cache/vectoriadb',
namespace: 'tool-index',
}),
toolsHash: SerializationUtils.createToolsHash(documents),
version: process.env.npm_package_version,
});
await toolIndex.initialize();
if (toolIndex.size() === 0) {
await toolIndex.addMany(documents);
await toolIndex.saveToStorage(); // Persist to disk
}
```
## How Persistence Works
1. **Initialize**: VectoriaDB checks for cached data
2. **Validate**: Cache is validated against `toolsHash`, `version`, and `modelName`
3. **Load or Index**: Valid cache is loaded; otherwise re-indexing occurs
4. **Save**: Call `saveToStorage()` to persist changes
## Cache Invalidation
VectoriaDB automatically invalidates the cache when documents change:
```ts title="src/cache-invalidation.ts" theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
const toolIndex = new VectoriaDB({
storageAdapter: new FileStorageAdapter({ cacheDir: './.cache' }),
// Hash of document contents - invalidates when documents change
toolsHash: SerializationUtils.createToolsHash(documents),
// Application version - invalidates on deployments
version: process.env.npm_package_version,
});
```
### Validation Checks
On `initialize()`, VectoriaDB checks:
1. Does the cache file/key exist?
2. Does `toolsHash` match?
3. Does `version` match?
4. Does `modelName` match?
If any check fails, the cache is invalidated and re-indexing occurs.
## Manual Storage Operations
```ts title="src/manual-storage.ts" theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
// Save current state to storage
await toolIndex.saveToStorage();
// Load from storage (done automatically on initialize)
await toolIndex.loadFromStorage();
// Clear storage
await toolIndex.clearStorage();
```
## Multi-Tenant Isolation
Use namespaces to isolate different indexes:
```ts title="src/multi-tenant.ts" theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
// Tenant A
const tenantAIndex = new VectoriaDB({
storageAdapter: new RedisStorageAdapter({
client: redisClient,
namespace: 'tenant-a',
}),
});
// Tenant B
const tenantBIndex = new VectoriaDB({
storageAdapter: new RedisStorageAdapter({
client: redisClient,
namespace: 'tenant-b',
}),
});
```
## Choosing an Adapter
Single-server deployments
Multi-pod environments
Development and testing
## Related
Advanced cache control
Production configuration