# TencentDB Agent Memory Operating Systems Support: Linux, macOS and Docker Deployment

> Discover TencentDB Agent Memory operating systems support. Learn how to deploy on Linux, macOS, and Docker for efficient memory management. Get started now.

- Repository: [Tencent Cloud/TencentDB-Agent-Memory](https://github.com/TencentCloud/TencentDB-Agent-Memory)
- Tags: getting-started
- Published: 2026-08-25

---

**TencentDB Agent Memory runs exclusively on POSIX-compatible operating systems including Linux and macOS, with the codebase explicitly blocking Windows environments through file path validation checks in the ingestion engine.**

TencentDB Agent Memory is an open-source memory hub designed for database agent ecosystems. Understanding which operating systems are supported is critical for deployment planning, as the project enforces strict POSIX compliance while explicitly excluding Windows platforms. Based on the source code analysis of the `TencentCloud/TencentDB-Agent-Memory` repository, the system is architected for Linux containers and Unix-like environments.

## Supported Platforms and POSIX Compliance

The TencentDB Agent Memory codebase is engineered for POSIX-compliant systems. This design choice ensures reliable file system operations, process management, and networking stack compatibility required for the memory ingestion engine.

### Linux Native Support

Linux serves as the primary deployment target for TencentDB Agent Memory. The project's Docker images are built on Linux bases, and the core file ingestion logic assumes Unix-style path structures. According to the deployment documentation in [`deploy/global-images/README.md`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/deploy/global-images/README.md) and [`INSTALL.md`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/INSTALL.md), production installations utilize Linux containers with specific port mappings and volume mounts optimized for Unix file permissions.

### macOS Compatibility

While not natively compiled for macOS architecture in all components, TencentDB Agent Memory supports macOS through Docker Desktop. Since the deployment architecture relies on Linux containers, any host operating system capable of running Docker—including macOS with Docker Desktop—can host the memory hub. This effectively extends operating system support to macOS developers through containerization.

## Windows Exclusion and Path Validation

Unlike many cross-platform database tools, TencentDB Agent Memory explicitly rejects Windows environments. The ingestion engine contains hardcoded checks that prevent operation on Windows systems by validating file path formats.

In [`MemoryKnowledge/src/engines/wiki/ingest-v2/file-protocol.ts`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/MemoryKnowledge/src/engines/wiki/ingest-v2/file-protocol.ts), the file protocol implementation explicitly blocks Windows absolute paths:

```typescript
// src/engines/wiki/ingest-v2/file-protocol.ts
// Windows absolute paths are explicitly rejected:
//   // 拒绝绝对路径与 Windows 盘符
if (path.startsWith('C:\\') || path.match(/^[A-Z]:\\/)) {
  throw new Error('Windows absolute paths are not supported');
}

```

This validation demonstrates that **Windows is not a supported operating system** for core components. The rejection of drive letters (C:\, D:\, etc.) at the code level ensures the system maintains POSIX path assumptions throughout the ingestion pipeline.

## Docker-Based Deployment Architecture

The standard deployment method utilizes Linux containers, making the effective operating system requirement a Linux-capable runtime environment. The `docker run` configuration specified in the installation guides uses Linux-based images from `docker.io/agentmemory/memory-hub:latest`.

Example Docker deployment command:

```bash

# Docker deployment (Linux based)

docker run -d --name tdai-memory-hub \
  -p 8125:8125 -p 8424:8424 \
  -e REMOTE_INSTANCE_URL=http://host.docker.internal:8420 \
  -e LLM_MODE=custom \
  docker.io/agentmemory/memory-hub:latest

```

This containerized approach means that while the host operating system can vary (Linux directly, or macOS via Docker Desktop), the runtime environment remains a consistent Linux system.

## Summary

- **Linux** is the primary supported operating system for native and containerized deployments of TencentDB Agent Memory
- **macOS** is supported via Docker Desktop, leveraging Linux containers to provide full compatibility
- **Windows** is explicitly unsupported, with file path validation in [`file-protocol.ts`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/file-protocol.ts) rejecting Windows-style absolute paths
- The deployment architecture requires POSIX compliance, with all official Docker images based on Linux systems

## Frequently Asked Questions

### Does TencentDB Agent Memory support Windows operating systems?

No, TencentDB Agent Memory does not support Windows. The source code in [`MemoryKnowledge/src/engines/wiki/ingest-v2/file-protocol.ts`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/MemoryKnowledge/src/engines/wiki/ingest-v2/file-protocol.ts) explicitly rejects Windows absolute paths by checking for drive letter patterns (such as `C:\` or `D:\`) and throwing errors when detected. This architectural decision ensures POSIX compliance but prevents Windows deployment.

### Can I run TencentDB Agent Memory on macOS without Docker?

The project is designed for Linux containers as specified in [`deploy/global-images/README.md`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/deploy/global-images/README.md) and [`INSTALL.md`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/INSTALL.md). While some components may run natively on macOS due to its Unix foundation, the recommended and supported deployment method uses Docker, ensuring consistent Linux runtime environments across development and production.

### Which Linux distributions are compatible with TencentDB Agent Memory?

Any Linux distribution capable of running Docker containers is compatible, including Ubuntu, CentOS, Debian, and RHEL. Since the application runs inside Linux containers, the specific host distribution matters less than having a functional Docker runtime and POSIX-compliant file system.

### Is there a way to bypass the Windows path restriction in the ingestion engine?

No, the Windows path restriction is hardcoded into the file protocol validation logic. Attempting to run the ingestion components on Windows will trigger the explicit error thrown in [`file-protocol.ts`](https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/main/file-protocol.ts) when Windows-style paths are detected, making the system functionally incompatible with Windows environments regardless of compatibility layers.