Skip to content

Security: Kartalops/Dokploy-MCP

Security

SECURITY.md

Security Policy

Supported Versions

Version Supported
0.1.x ⚠️ Alpha — not production-ready

Reporting a Vulnerability

If you discover a security vulnerability in dokploy-mcp, please do not open a public issue.

Instead, email the maintainers directly. You should receive a response within 48 hours.

When reporting, include:

  • Description of the vulnerability
  • Steps to reproduce
  • Potential impact
  • Optionally: suggested fix

Security Considerations

API Keys

  • dokploy-mcp uses x-api-key header authentication
  • The API key is passed via the DOKPLOY_API_KEY environment variable
  • Never log API keys — all logging redacts sensitive values
  • Never commit API keys to version control

MCP Tool Behavior

dokploy-mcp exposes mutating tools (create_application, update_application, assign_domain, trigger_deploy). These tools:

  • Require explicit human approval before execution (via the MCP protocol)
  • Should be scoped to specific project/application permissions in Dokploy
  • Are not safe to expose to untrusted users without Dokploy API key protection

Docker-in-Docker

  • Dokploy supports Docker-in-Docker (DinD) builds
  • DinD builds require significant RAM/CPU — set explicit resource limits
  • The recommend_build_strategy tool warns about resource-intensive builds

Deployment Risks

  • Persistent volume data loss: always use ephemeral: false for persistent data
  • Production misconfiguration: generateProductionRecommendations warns about common issues
  • Secret exposure: mitigated by passing secrets via x-api-key header (never logged)
  • Resource exhaustion: resource limits must be set explicitly

Dependencies

Run npm audit before each release to check for known vulnerabilities in dependencies.

There aren't any published security advisories