AdLemur
Back to Docs

Self-Hosting AdLemur

Run AdLemur on your own infrastructure with your own provider credentials.

AdLemur source is available under the MIT license. A self-hosted deployment uses your infrastructure and your provider credentials. DataForSEO bills monitoring and paid-keyword requests directly; OpenRouter bills optional AI analysis and generation directly.

There are two self-hosting paths:

  • Simple: Docker, recommended for personal use on your own machine. Easiest way to get started.
  • Advanced: Cloudflare, for an internet-facing deployment across multiple devices or with your team.

DataForSEO API key setup

AdLemur uses DataForSEO for provider-backed monitoring and paid-search research. DataForSEO is a paid third-party service unaffiliated with AdLemur.

  1. Go to DataForSEO API Access.
  2. Click "Send by email" to get your credentials.
  3. Copy the longer credentials labelled "Base64" credentials.
  4. Set this as DATAFORSEO_API_KEY in your environment:
    • Docker: .env
    • Cloudflare: as a Worker secret in the dashboard
    • Local development: .env.local

Optional features

Connected ad accounts

Connecting your own ad accounts is optional and works in self-hosted deployments using your own OAuth clients. See the ad accounts guide on GitHub.

AI features (SAM)

SAM, creative analysis, and media generation are optional. Set OPENROUTER_API_KEY to enable supported AI workflows. OpenRouter charges the deployment operator for model usage.