> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getomni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory

> Configure organization-wide AI memory behavior

## Overview

Memory lets Omni retain selected context across future chats and background agent runs. It is disabled by default and must be enabled at deployment time with `MEMORY_ENABLED=true`.

<Note>
  Memory requires an active embedding provider. Configure one in **Settings** → **Embedding Providers** before enabling memory for users.
</Note>

## Admin Settings

Navigate to **Settings** → **Memory** to configure:

| Setting          | Description                                                                          |
| ---------------- | ------------------------------------------------------------------------------------ |
| **Default mode** | Organization-wide memory ceiling and default for users without a personal preference |
| **Memory model** | LLM used to extract and recall memories. If unset, Omni uses the default chat model  |

### Memory Modes

| Mode            | Behavior                                                                         |
| --------------- | -------------------------------------------------------------------------------- |
| **Off**         | Memory is disabled for all users and agents                                      |
| **Chat memory** | Completed chat turns can be summarized into memories and recalled in later chats |
| **Full memory** | Chat memory plus agent run context for background agents                         |

The organization default is a ceiling. Users can choose a lower personal mode from **Settings** → **Memory**, but cannot exceed the mode selected by an admin.

## User Controls

Users can view and delete their own memories from **Settings** → **Memory**. They can also delete all stored memories for their account.

<Warning>
  Deleting memories is permanent. Omni will not be able to recall deleted context in future chats.
</Warning>

## Deployment Configuration

Set these environment variables before starting Omni:

| Variable          | Default | Description                                                        |
| ----------------- | ------- | ------------------------------------------------------------------ |
| `MEMORY_ENABLED`  | `false` | Enables Memory settings pages and AI-service memory initialization |
| `MEMORY_PROVIDER` | `mem0`  | Memory backend provider. `mem0` is currently supported             |

See [Configuration Reference](/deployment/configuration#memory-configuration) for the full environment variable reference.