Self-Hosting

Mudabbir is designed to be self-hosted. Here’s how to deploy it on your own server.

Requirements

• Python 3.11+
• 2GB RAM minimum (4GB recommended with Mem0)
• Linux, macOS, or Windows (Linux recommended for servers)
• Anthropic API key (for Claude Agent SDK backend)

Basic Deployment

Install

# Create a dedicated user (optional)
sudo useradd -m -s /bin/bash mudabbir

# Install Mudabbir
curl -fsSL https://mudabbir.fly.dev/install.sh | sh

Configure

Create the config file:

mkdir -p ~/.mudabbir
cat > ~/.mudabbir/config.json << 'EOF'
{
  "anthropic_api_key": "sk-ant-your-key",
  "agent_backend": "claude_agent_sdk",
  "tool_profile": "coding"
}
EOF
chmod 600 ~/.mudabbir/config.json

Run

mudabbir

The dashboard starts on http://0.0.0.0:8888.

Production Deployment

Behind a Reverse Proxy

For production, put Mudabbir behind nginx or Caddy:

Caddy (recommended):

mudabbir.example.com {
    reverse_proxy localhost:8888
}

nginx:

server {
    listen 443 ssl;
    server_name mudabbir.example.com;

    ssl_certificate /etc/ssl/certs/mudabbir.crt;
    ssl_certificate_key /etc/ssl/private/mudabbir.key;

    location / {
        proxy_pass http://localhost:8888;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Environment Variables

Set environment variables in a .env file or your system’s environment:

MUDABBIR_ANTHROPIC_API_KEY=sk-ant-...
MUDABBIR_WEB_HOST=127.0.0.1
MUDABBIR_WEB_PORT=8888
MUDABBIR_TOOL_PROFILE=coding

Security Hardening

1. Run as a dedicated user — Don’t run as root
2. Restrict file permissions — Config files should be 600
3. Use a firewall — Only expose the reverse proxy port
4. Enable Guardian AI — Active by default with Anthropic key
5. Set allowed IDs — Restrict channel access to specific users
6. Run security audit — mudabbir --security-audit

Resource Planning

For a typical deployment with Claude Agent SDK (cloud) and Mem0 with Ollama:

• Minimum: 4GB RAM, 2 CPU cores
• Recommended: 8GB RAM, 4 CPU cores