{
  "manifest_version": "1",
  "slug": "deer-flow",
  "title": "DeerFlow",
  "headline": "Self-host DeerFlow for deep research",
  "description": "Self-host ByteDance's DeerFlow on an exe.dev VM with Docker: deep-research reports from Claude and GPT with no API keys, in a web UI behind your login.",
  "category": "ai-agents",
  "tags": [
    "deerflow",
    "deer-flow",
    "deerflow self-host",
    "deerflow docker",
    "bytedance deerflow",
    "deep research agent",
    "super agent harness",
    "ai research assistant",
    "langgraph",
    "mcp",
    "open source deep research"
  ],
  "url": "https://exe.dev/deploy/deer-flow",
  "markdown_url": "https://exe-staging.dev/deploy/deer-flow.md",
  "upstream": {
    "website": "https://deerflow.tech",
    "source": "https://github.com/bytedance/deer-flow",
    "docs": "https://github.com/bytedance/deer-flow/tree/main/backend/docs",
    "license": "MIT"
  },
  "example_vm_name": "my-deer-flow",
  "time": "15 minutes",
  "stack": [
    {
      "name": "DeerFlow 2.2.0",
      "detail": "The release's own production Compose stack (`make up`): Next.js web UI, Python gateway with the agent runtime, Redis and nginx, built on the VM",
      "port": 8000,
      "data": "~/deer-flow/backend/.deer-flow"
    },
    {
      "name": "Settings",
      "detail": "config.yaml (models, tools, sandbox, accounts) and .env",
      "data": "~/deer-flow/config.yaml"
    },
    {
      "name": "exe.dev LLM integration",
      "detail": "Claude Sonnet 5.5 and GPT-5.4 mini, with no API key on the VM"
    },
    {
      "name": "Search and fetch",
      "detail": "DuckDuckGo search and the Jina reader, both keyless; SearXNG if you add it"
    },
    {
      "name": "Nightly backup",
      "detail": "systemd timer; database, settings, secrets and files",
      "data": "~/backups/deer-flow"
    }
  ],
  "access": [
    {
      "url": "https://my-deer-flow.exe.xyz/",
      "who": "private",
      "what": "The DeerFlow web UI, behind your exe.dev login and a DeerFlow account"
    },
    {
      "url": "https://my-deer-flow.exe.xyz/api/langgraph/",
      "who": "private",
      "what": "The run API, for scripts and other VMs with a VM token and a DeerFlow access token"
    }
  ],
  "delivers": [
    "DeerFlow 2.2.0 from its official Docker Compose deployment, restarted after a reboot.",
    "A private web UI at `https://\u003cvm\u003e.exe.xyz/`, with you as the admin and sign-ups closed.",
    "Claude Sonnet 5.5 and GPT-5.4 mini through exe.dev's LLM integration, with no API keys.",
    "Deep research with keyless web search and page fetching, ending in a Markdown report you can download.",
    "Nightly backups of chats, reports, settings and secrets in `~/backups/deer-flow`."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20DeerFlow%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fdeer-flow.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-deer-flow.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-deer-flow.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AThis%20recipe%20needs%20a%2050GB%20disk%2C%20and%20a%20new%20VM%27s%20may%20be%20smaller.%20Before%20you%20install%20anything%2C%20run%20%60df%20-h%20%2F%60.%20If%20its%20size%20is%20under%2045G%2C%20stop%20and%20ask%20me%20to%20grow%20the%20disk%2C%20either%20with%20this%20link%3A%20https%3A%2F%2Fexe.dev%2Fsuggest%3Fcommand%3Dresize%2520my-deer-flow%2520--disk%253D50GB%20or%2C%20on%20my%20computer%2C%20with%20%60ssh%20exe.dev%20resize%20my-deer-flow%20--disk%3D50GB%60.%20When%20I%20say%20it%27s%20done%2C%20run%20%60sudo%20resize2fs%20%22%24%28findmnt%20-no%20SOURCE%20%2F%29%22%60%2C%20check%20%60df%20-h%20%2F%60%20again%2C%20and%20carry%20on.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20DeerFlow%202.2.0%20from%20its%20official%20Docker%20Compose%20deployment%2C%20restarted%20after%20a%20reboot.%0A-%20A%20private%20web%20UI%20at%20%60https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%60%2C%20with%20you%20as%20the%20admin%20and%20sign-ups%20closed.%0A-%20Claude%20Sonnet%205.5%20and%20GPT-5.4%20mini%20through%20exe.dev%27s%20LLM%20integration%2C%20with%20no%20API%20keys.%0A-%20Deep%20research%20with%20keyless%20web%20search%20and%20page%20fetching%2C%20ending%20in%20a%20Markdown%20report%20you%20can%20download.%0A-%20Nightly%20backups%20of%20chats%2C%20reports%2C%20settings%20and%20secrets%20in%20%60~%2Fbackups%2Fdeer-flow%60.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20first%2C%20skipping%20VM%20creation%20and%20SSH%20but%20not%20the%0Adisk%20check%2C%20through%20%22Set%20up%20nightly%20backups%22.%20The%20walkthrough%20at%20the%20top%0Ais%20for%20the%20owner%20afterwards.%20The%20build%20takes%20about%20five%20minutes%20on%204%0ACPUs%20and%20longer%20on%202%3B%20that%20is%20normal.%20Never%20print%20~%2Fdeer-flow-admin.txt%2C%0A.env%20or%20the%20files%20under%20backend%2F.deer-flow%20into%20the%20chat%3B%20tell%20the%20owner%0Awhere%20the%20password%20is.%20Don%27t%20make%20the%20VM%20public%2C%20don%27t%20switch%20on%20the%0ADocker%20sandbox%2C%20and%20don%27t%20create%20access%20tokens%20unless%20the%20owner%20asks.%0AFinish%20by%20giving%20the%20owner%20the%20URL%20and%20where%20the%20password%20is.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "disk": "50GB",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/deer-flow/prompt.txt | ssh exe.dev new --disk=50GB --prompt=/dev/stdin",
    "prompt": "Set up DeerFlow on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/deer-flow.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-deer-flow. This VM's name is the output of `hostname`: use it wherever the recipe writes my-deer-flow. Skip the step that creates the VM; you are on it.\n\nThis recipe needs a 50GB disk, and a new VM's may be smaller. Before you install anything, run `df -h /`. If its size is under 45G, stop and ask me to grow the disk, either with this link: https://exe.dev/suggest?command=resize%20my-deer-flow%20--disk%3D50GB or, on my computer, with `ssh exe.dev resize my-deer-flow --disk=50GB`. When I say it's done, run `sudo resize2fs \"$(findmnt -no SOURCE /)\"`, check `df -h /` again, and carry on.\n\nYou are done when all of these are true. Check each one yourself:\n- DeerFlow 2.2.0 from its official Docker Compose deployment, restarted after a reboot.\n- A private web UI at `https://\u003cvm\u003e.exe.xyz/`, with you as the admin and sign-ups closed.\n- Claude Sonnet 5.5 and GPT-5.4 mini through exe.dev's LLM integration, with no API keys.\n- Deep research with keyless web search and page fetching, ending in a Markdown report you can download.\n- Nightly backups of chats, reports, settings and secrets in `~/backups/deer-flow`.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" first, skipping VM creation and SSH but not the\ndisk check, through \"Set up nightly backups\". The walkthrough at the top\nis for the owner afterwards. The build takes about five minutes on 4\nCPUs and longer on 2; that is normal. Never print ~/deer-flow-admin.txt,\n.env or the files under backend/.deer-flow into the chat; tell the owner\nwhere the password is. Don't make the VM public, don't switch on the\nDocker sandbox, and don't create access tokens unless the owner asks.\nFinish by giving the owner the URL and where the password is.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/deer-flow/prompt.txt"
  },
  "published": "2026-11-22",
  "updated": "2026-11-22",
  "verified": "2026-11-22",
  "related": [
    "searxng",
    "firecrawl",
    "open-webui",
    "dify",
    "hermes-agent",
    "openclaw"
  ],
  "alternatives": [
    "ChatGPT deep research",
    "Gemini Deep Research",
    "Perplexity"
  ]
}
