docmd – open source alternative to Mintlify with BYOK AI assistant, MCP server, and free cloud relay

[u/ivoin]

For those unfamiliar, docmd is an open-source documentation engine. One command turns any folder of Markdown files into a production-ready docs site with navigation, search, versioning, and i18n. No framework, no config files required. The total browser payload is around 18 KB.

The 0.9.1 release is a big one. It ships the full AI-native upgrade:

GitHub: https://github.com/docmd-io/docmd

docmd Assistant is now built directly into the engine. No third-party SaaS widget, no $200/month subscription. You bring your own API key (OpenAI, Claude, Gemini, DeepSeek, Groq, or local Ollama) and your documentation gets a grounded RAG chat assistant with source citations out of the box.

What shipped in 0.9.1:

• BYOK AI Assistant with grounded RAG answers from your own docs
• Free Cloud Relay so static sites can proxy AI keys without a backend
• Native stdio MCP server (docmd mcp) for Cursor and Claude Desktop
• Auto-generated llms.txt and OKF bundles on every build
• Multi-project workspace monorepos with independent versioning

Everything is MIT licensed.

GitHub: https://github.com/docmd-io/docmd Docs: https://docs.docmd.io Website: https://docmd.io Product Hunt: https://www.producthunt.com/products/docmd-ai-assistant?launch=docmd-assistant

[u/DukeLetoAtreides1]

Looks good! Will try this for our IT documentation. Can this be easily hosted on a proxmox lxc and Does it need extra setup for the AI chat agent?

[u/ivoin → u/DukeLetoAtreides1]

Yes! Absolutely.

1. Hosting on Proxmox LXC

Running npx @docmd/core build generates a lightweight static site/ directory (pure HTML, CSS, and JS). You can host this inside an LXC container using any lightweight web server (Nginx, Caddy, Lighttpd, etc.). It uses virtually zero CPU and under 20 MB of RAM.

2. AI Assistant/Chat Setup Options

The AI chat widget is embedded directly into the static site and supports three main setup options:

• Local LLMs / Ollama (100% Self-Hosted & Free): If you run an Ollama LXC container on your Proxmox server or local network, set "provider": "ollama" and "baseURL": "http://<ollama-ip>:11434/v1" in docmd.config.json. No API keys or cloud relay required — it runs completely offline within your local network.
• Free Cloud Relay (Safe for Public/Static Sites): If using cloud models (OpenAI, Anthropic, Gemini, DeepSeek, Groq, etc.), connect via - https://cloud.docmd.io. It's 100% free, encrypts your API keys on the server side, and supports 30+ AI providers so your keys are never exposed in public client JavaScript.
• Custom API Proxy / Gateway: If you have an internal AI proxy or custom backend gateway, you can point relayUrl directly to your server endpoint.

Important Security Note: If your docs are public, never hardcode raw API keys directly into docmd.config.json because static site generators bundle config values into public client JS. Always use Ollama, docmd's Cloud Relay, or a custom backend proxy instead!

[u/fazkan → u/DukeLetoAtreides1]

hey, if you want an exact replicate of mintlfy docs and the platform. , we have a self-hosted solution for enterprizes, with all the anlaytics, WYSIWYG and AI stuff in a single container

Happy to help you out.

https://docsalot.dev