Developer Knowledge Base

AgentFactory Developer Docs

Practical technical notes for engineers: copyable commands, clear configuration examples, official references, and focused troubleshooting steps.

Published Guides

45

Topic Hubs

6

Format

Answer-first docs

MCP Servers and Client Integration

Setup, permissions, configuration, and troubleshooting for MCP servers used with Claude Desktop, Cursor, and other AI clients.

2 guides

Docker and Container Deployment

Docker, Compose, image builds, container networking, permissions, and production deployment fixes.

2 guides

Database Integration and Performance

PostgreSQL, MySQL, Redis, MongoDB, SQLite, connection setup, caching, indexes, tuning, and operational fixes.

21 guides

Frontend Build and Performance

Next.js, React, Vite, Webpack, Tailwind CSS, hydration, build errors, performance, and deployment issues.

10 guides

Developer Troubleshooting

Common development, deployment, build, runtime, dependency, timeout, and permission errors with direct fixes.

3 guides

Technical Comparisons and Choices

Side-by-side comparisons for databases, deployment platforms, runtimes, frameworks, and developer tools.

7 guides

Latest Guides

github-actions-cache-not-found-fix

Fix GitHub Actions Cache Not Found: Root Causes and Minimal Checks

Fix GitHub Actions Cache Not Found: Root Causes and Minimal Checks Quick Answer - Conclusion: GitHub Actions cache misses are almost always caused by ...

kubernetes-ingress-404-path-rewrite

Kubernetes Ingress 404 Path Rewrite: Configure Custom Error Pages and Fallback Routes

Kubernetes Ingress 404 Path Rewrite: Configure Custom Error Pages and Fallback Routes Quick Answer - What it does: Rewrites unmatched Kubernetes Ingre...

clickhouse-too-many-parts-error-fix

Fix ClickHouse "Too Many Parts" Error: Root Causes and Minimal Fixes

Fix ClickHouse "Too Many Parts" Error: Root Causes and Minimal Fixes Quick Answer - Conclusion: The "Too many parts" exception occurs when the number ...

mongodb-sort-exceeded-memory-limit

Fix MongoDB Sort Exceeded Memory Limit: Root Causes and Minimal Fixes

Fix MongoDB Sort Exceeded Memory Limit: Root Causes and Minimal Fixes Quick Answer - Conclusion: The Sort exceeded memory limit error occurs when Mong...

mongodb-connection-pool-timeout-fix

MongoDB Connection Pool Timeout Fix: Configure Timeouts and Pool Limits Correctly

MongoDB Connection Pool Timeout Fix: Configure Timeouts and Pool Limits Correctly Quick Answer - Conclusion: MongoDB connection pool timeouts are almo...

redis-lua-script-time-limit-exceeded

Redis Lua Script Time Limit Exceeded: Root Causes and Minimal Fixes

Redis Lua Script Time Limit Exceeded: Root Causes and Minimal Fixes Quick Answer - What it is: Redis's lua-time-limit (default 5000ms) is a soft thres...

redis-readonly-replica-write-error

Redis Replication Setup: Master-Replica Configuration and Troubleshooting

Redis Replication Setup: Master-Replica Configuration and Troubleshooting Quick Answer - What it does: Redis replication creates real-time copies of a...

redis-maxmemory-policy-eviction-tuning

Redis maxmemory-policy: Configure Eviction Strategies for Production

Redis maxmemory-policy: Configure Eviction Strategies for Production Quick Answer - What it does: maxmemory-policy controls how Redis evicts keys when...

mysql-utf8mb4-index-length-error

Fix MySQL utf8mb4 Index Length Error: Root Causes and Minimal Checks

Fix MySQL utf8mb4 Index Length Error: Root Causes and Minimal Checks Quick Answer - Conclusion: The Specified key was too long; max key length is 767 ...

mysql-too-many-connections-pool-sizing

Fix MySQL "Too Many Connections": Root Causes and Connection Pool Scaling

Fix MySQL "Too Many Connections": Root Causes and Connection Pool Scaling Quick Answer - The error ERROR 1040 (HY000): Too many connections means the ...

mysql-lock-wait-timeout-exceeded-fix

Fix MySQL Lock Wait Timeout Exceeded: Root Causes and Minimal Checks

Fix MySQL Lock Wait Timeout Exceeded: Root Causes and Minimal Checks Quick Answer - Primary cause: A transaction holds a row-level lock that another t...

postgres-deadlock-detected-query-fix

Fix PostgreSQL Deadlock Detected: Root Causes and Minimal Checks

Fix PostgreSQL Deadlock Detected: Root Causes and Minimal Checks Quick Answer - Conclusion: PostgreSQL deadlocks occur when two or more transactions h...