mem0-aio
mem0-aio
Docker app from JSONbored's Repository
Overview
Mem0 OpenMemory gives LLM apps a persistent memory layer with a web UI, MCP/API server, and pluggable vector backends.
All-In-One Unraid Editionmem0-aio packages the OpenMemory UI, API, and embedded Qdrant into one Unraid-first container so beginners can get a working first boot without wiring a separate vector database.
Quick Install (Beginners)
- Install the template and leave the default appdata path in place.
- For the fastest hosted path, set [code]OPENAI_API_KEY[/code].
- For the normal local-LLM homelab path, set [code]OLLAMA_BASE_URL[/code] to your external Ollama root URL and set the Ollama chat/embed models you actually have pulled.
- Start the container and open the Web UI. The wrapper will auto-default to Ollama when [code]OLLAMA_BASE_URL[/code] is set and no explicit provider overrides are supplied.
- Leave the direct API/MCP port unpublished unless you intentionally need external MCP/API clients behind your own access controls. If you publish it, set [code]MEM0_API_HOST=0.0.0.0[/code] and protect that endpoint yourself.
Advanced View
- Leave storage defaults in place for the bundled SQLite + Qdrant path.
- If you use external vector storage, configure exactly one backend. The wrapper rejects competing selectors such as Redis plus PGVector plus external Qdrant because OpenMemory can only initialize one vector store at a time.
- Provider overrides are available for native Ollama, OpenAI-compatible endpoints, hosted model providers, and supported external vector stores, but only set the fields your chosen path needs.
Important Notes
- This wrapper is meant to simplify first boot on Unraid, not remove the real complexity of model/provider credentials and external-service tuning.
- Actual memory generation still requires a valid LLM/embedder configuration. Leaving [code]OPENAI_API_KEY[/code] blank is fine if you are using Ollama, but you still need to provide a reachable Ollama endpoint and valid model names.
- Native Ollama uses the root API URL such as [code]http://host.docker.internal:11434[/code], not an OpenAI-compatible [code]/v1[/code] path. If your reverse proxy adds auth and only exposes an OpenAI-style [code]/v1[/code] endpoint, use the advanced OpenAI-compatible base URL fields instead of the native Ollama provider path.
- The embedded Qdrant service is intentionally bundled for the beginner AIO path; it is skipped only when one valid external vector backend is configured.
Requirements
Runtime arguments
- Web UI
http://[IP]:[PORT:3000]- Network
bridge- Shell
sh- Privileged
- false
Template configuration
Main OpenMemory web interface port.
- Target
- 3000
- Default
- 3000
- Value
- 3000
Optional direct API and MCP host port. Leave blank for normal UI-only access. If you publish this port, also set [Security] API Bind Address (MEM0_API_HOST) to 0.0.0.0 and protect access at your network or reverse proxy.
- Target
- 8765
Persistent storage for the SQLite database, embedded Qdrant data, and AIO state.
- Target
- /mem0/storage
- Default
- /mnt/user/appdata/mem0-aio/storage
- Value
- /mnt/user/appdata/mem0-aio/storage
Optional hosted-provider quick start. Leave blank if you plan to use Ollama instead.
- Target
- OPENAI_API_KEY
Default user namespace used by the API and MCP server.
- Target
- USER
- Default
- default_user
- Value
- default_user
Native external Ollama root URL. Example: http://host.docker.internal:11434 or http://192.168.1.10:11434. When set, the wrapper auto-defaults to Ollama if no explicit provider override is supplied.
- Target
- OLLAMA_BASE_URL
Optional Ollama chat model override. Set this to a model you already have pulled on your Ollama server. Example: llama3.1:latest or mistral:7b
- Target
- LLM_MODEL
Optional Ollama embedding model override. Set this to a model you already have pulled on your Ollama server. Example: nomic-embed-text
- Target
- EMBEDDER_MODEL
Bind address for the internal API/MCP server. Keep 127.0.0.1 for UI-only access; use 0.0.0.0 only when deliberately publishing the API/MCP port behind your own LAN, VPN, firewall, or reverse-proxy controls.
- Target
- MEM0_API_HOST
- Default
- 127.0.0.1
- Value
- 127.0.0.1
Default same-origin proxy path for the web UI. Leave this alone unless you intentionally want the browser to call a different API URL directly.
- Target
- NEXT_PUBLIC_API_URL
- Default
- /openmemory-api
- Value
- /openmemory-api
Default user ID shown in the browser client. Usually keep this aligned with USER.
- Target
- NEXT_PUBLIC_USER_ID
- Default
- default_user
- Value
- default_user
Advanced provider override. Leave this on auto for the normal wrapper behavior: OpenAI when no Ollama URL is set, or Ollama when OLLAMA_BASE_URL is set.
- Target
- LLM_PROVIDER
- Default
- auto|openai|anthropic|azure_openai|ollama|together|groq|litellm|mistralai|google_ai|aws_bedrock|gemini|deepseek|xai|lmstudio|langchain
- Value
- auto
Optional provider-specific API key if you are not using OPENAI_API_KEY or if you want the LLM to use a different secret.
- Target
- LLM_API_KEY
Optional custom LLM API base URL for OpenAI-compatible or provider-specific endpoints. Use this for auth-protected OpenAI-style proxies, usually ending in /v1.
- Target
- LLM_BASE_URL
Optional host override used by upstream Docker Ollama auto-detection. Example: host.docker.internal
- Target
- OLLAMA_HOST
Advanced embedder provider override. Leave this on auto for the normal wrapper behavior so the embedder follows the matching OpenAI or Ollama path.
- Target
- EMBEDDER_PROVIDER
- Default
- auto|openai|azure_openai|ollama|huggingface|vertexai|gemini|lmstudio|together|langchain|aws_bedrock
- Value
- auto
Optional provider-specific embedder API key.
- Target
- EMBEDDER_API_KEY
Optional custom embedder API base URL. Use this for OpenAI-compatible or separate embedding endpoints, including auth-protected proxies that expose /v1.
- Target
- EMBEDDER_BASE_URL
Optional explicit embedding dimension override for vector-store setup. Usually leave blank and let the wrapper auto-detect it, but set this if your embedder is custom or auto-detection cannot determine the correct size.
- Target
- EMBEDDER_DIMENSIONS
Advanced override for the API database connection. Leave the default SQLite path for normal AIO usage.
- Target
- DATABASE_URL
- Default
- sqlite:////mem0/storage/openmemory.db
- Value
- sqlite:////mem0/storage/openmemory.db
Legacy upstream alias used by older OpenMemory examples that referenced env:API_KEY. Leave blank unless you intentionally depend on that older pattern.
- Target
- API_KEY
External Qdrant URL, for example http://qdrant:6333 or https://qdrant.example.com. Use this instead of external QDRANT_HOST when auth or HTTPS is involved. Do not combine with Redis, PGVector, or other vector backends.
- Target
- QDRANT_URL
Bundled Qdrant host by default. Leave as 127.0.0.1 for the AIO path; set to an external host only when Qdrant is the one external vector backend you want.
- Target
- QDRANT_HOST
- Default
- 127.0.0.1
- Value
- 127.0.0.1
Qdrant port for the bundled or selected external Qdrant backend.
- Target
- QDRANT_PORT
- Default
- 6333
- Value
- 6333
API key for authenticated external Qdrant. Requires QDRANT_URL or an external QDRANT_HOST; the bundled Qdrant service is not started with API-key auth.
- Target
- QDRANT_API_KEY
Controls Qdrant usage-statistics reporting for the bundled embedded vector store. Default is true so the AIO image stays privacy-first by default.
- Target
- QDRANT__TELEMETRY_DISABLED
- Default
- true|false
- Value
- true
External Chroma host. Requires CHROMA_PORT and must be the only external vector backend configured.
- Target
- CHROMA_HOST
External Chroma port. Requires CHROMA_HOST.
- Target
- CHROMA_PORT
External Weaviate cluster URL. Use this or WEAVIATE_HOST/WEAVIATE_PORT, and do not combine with another vector backend.
- Target
- WEAVIATE_CLUSTER_URL
External Weaviate host. Requires WEAVIATE_PORT unless WEAVIATE_CLUSTER_URL is set.
- Target
- WEAVIATE_HOST
External Weaviate port. Requires WEAVIATE_HOST unless WEAVIATE_CLUSTER_URL is set.
- Target
- WEAVIATE_PORT
Redis-backed vector-store URL. Example: redis://:password@host:6379/0. This selects Redis as the vector backend; do not combine with PGVector or Qdrant.
- Target
- REDIS_URL
External PostgreSQL/pgvector host. Requires PG_PORT and must be the only external vector backend configured.
- Target
- PG_HOST
External PostgreSQL/pgvector port. Required when any PG_* vector-store setting is used.
- Target
- PG_PORT
External PostgreSQL database name for pgvector. Defaults to mem0 when PGVector is selected and this is blank.
- Target
- PG_DB
External PostgreSQL username for pgvector. Defaults to mem0 when PGVector is selected and this is blank.
- Target
- PG_USER
External PostgreSQL password for pgvector. Defaults to mem0 when PGVector is selected and this is blank.
- Target
- PG_PASSWORD
Optional external Milvus host.
- Target
- MILVUS_HOST
Optional external Milvus port.
- Target
- MILVUS_PORT
Optional Milvus token for authenticated deployments.
- Target
- MILVUS_TOKEN
Optional Milvus database name.
- Target
- MILVUS_DB_NAME
Optional external Elasticsearch host.
- Target
- ELASTICSEARCH_HOST
Optional external Elasticsearch port.
- Target
- ELASTICSEARCH_PORT
Optional Elasticsearch username.
- Target
- ELASTICSEARCH_USER
Optional Elasticsearch password.
- Target
- ELASTICSEARCH_PASSWORD
Whether the Elasticsearch HTTP endpoint uses HTTPS. Default is true because modern Elasticsearch containers usually expose HTTPS.
- Target
- ELASTICSEARCH_USE_SSL
- Default
- true|false
- Value
- true
Whether to verify Elasticsearch TLS certificates. Keep true for external HTTPS backends; set false only for a trusted self-signed endpoint on a private network.
- Target
- ELASTICSEARCH_VERIFY_CERTS
- Default
- true|false
- Value
- true
Optional external OpenSearch host.
- Target
- OPENSEARCH_HOST
Optional external OpenSearch port.
- Target
- OPENSEARCH_PORT
Optional OpenSearch username.
- Target
- OPENSEARCH_USER
Optional OpenSearch password.
- Target
- OPENSEARCH_PASSWORD
Whether the OpenSearch HTTP endpoint uses HTTPS. Default is true because modern OpenSearch containers usually expose HTTPS.
- Target
- OPENSEARCH_USE_SSL
- Default
- true|false
- Value
- true
Whether to verify OpenSearch TLS certificates. Keep true for external HTTPS backends; set false only for a trusted self-signed endpoint on a private network.
- Target
- OPENSEARCH_VERIFY_CERTS
- Default
- true|false
- Value
- true
Optional FAISS storage path inside the container or a mounted host path.
- Target
- FAISS_PATH
Optional one-shot filter for the bundled upstream export helper script. Only set this if you intentionally run the export tooling inside the container.
- Target
- EXPORT_USER_ID
Optional one-shot filter for the bundled upstream export helper script.
- Target
- EXPORT_APP_ID
Optional one-shot export filter. Epoch timestamp in seconds.
- Target
- EXPORT_FROM_DATE
Optional one-shot export filter. Epoch timestamp in seconds.
- Target
- EXPORT_TO_DATE
Categories
Download Statistics
Details
jsonbored/mem0-aio:latestRun mem0-aio on Unraid.
mem0-aio is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.