{
  "manifest_version": "1",
  "slug": "agno-agentos",
  "title": "Agno AgentOS",
  "headline": "Self-host Agno AgentOS on your own VM",
  "description": "Run Agno's AgentOS and PostgreSQL on an exe.dev VM: agents as durable services, models through the LLM integration, and the AgentOS UI over SSH.",
  "category": "ai-agents",
  "tags": [
    "agno",
    "agentos",
    "agno agentos",
    "agentos docker",
    "agno deploy",
    "agent platform",
    "os.agno.com",
    "pgvector",
    "claude agent",
    "codex agent"
  ],
  "url": "https://exe.dev/deploy/agno-agentos",
  "markdown_url": "https://exe.dev/deploy/agno-agentos.md",
  "upstream": {
    "website": "https://www.agno.com",
    "source": "https://github.com/agno-agi/agno",
    "docs": "https://docs.agno.com",
    "license": "Apache-2.0 (Agno and the agentos-docker template); the AgentOS UI is a hosted service"
  },
  "example_vm_name": "my-agentos",
  "time": "15 minutes",
  "stack": [
    {
      "name": "AgentOS",
      "detail": "The agentos-docker template, moved to Agno 3.2.0 (Python 3.14), in Docker Compose, with Super Agent",
      "port": 8000,
      "data": "~/agentos"
    },
    {
      "name": "PostgreSQL 18 with pgvector",
      "detail": "agnohq/pgvector:18 in Docker Compose; sessions, memory, knowledge, traces, schedules, and the run queue",
      "data": "the agentos_pgdata Docker volume"
    },
    {
      "name": "Models",
      "detail": "GPT (and Claude for Claude Engineer) through exe.dev's LLM integration"
    },
    {
      "name": "AgentOS UI",
      "detail": "os.agno.com in your browser, through an SSH tunnel to the VM"
    }
  ],
  "access": [
    {
      "url": "https://my-agentos.exe.xyz/docs",
      "who": "private",
      "what": "the AgentOS REST API and its interactive docs, behind exe.dev login"
    },
    {
      "url": "http://localhost:7777",
      "who": "private",
      "what": "the same API on your computer, through `ssh -L`; what os.agno.com connects to"
    },
    {
      "url": "ssh my-agentos.exe.xyz",
      "who": "private",
      "what": "the platform's code, data, and logs"
    }
  ],
  "delivers": [
    "AgentOS and PostgreSQL with pgvector in Docker Compose in ~/agentos, back after a reboot",
    "Super Agent answering through exe.dev's LLM integration, with no OpenAI or Anthropic key on the VM",
    "Port 8000 private behind exe.dev login, answering /health",
    "A generated database password in ~/agentos/.env, mode 600",
    "A nightly pg_dump of the database in ~/backups"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=Set%20up%20Agno%20AgentOS%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fagno-agentos.md%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-agentos.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-agentos.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20AgentOS%20and%20PostgreSQL%20with%20pgvector%20in%20Docker%20Compose%20in%20~%2Fagentos%2C%20back%20after%20a%20reboot%0A-%20Super%20Agent%20answering%20through%20exe.dev%27s%20LLM%20integration%2C%20with%20no%20OpenAI%20or%20Anthropic%20key%20on%20the%20VM%0A-%20Port%208000%20private%20behind%20exe.dev%20login%2C%20answering%20%2Fhealth%0A-%20A%20generated%20database%20password%20in%20~%2Fagentos%2F.env%2C%20mode%20600%0A-%20A%20nightly%20pg_dump%20of%20the%20database%20in%20~%2Fbackups%0A%0ARun%20%22Set%20up%20AgentOS%20by%20hand%22%20from%20%22On%20the%20VM%22%2C%20skipping%20VM%20creation%20and%0ASSH%2C%20then%20the%20backup%20commands%20in%20%22Back%20up%20and%20restore%22.%20The%20first%20build%0Atakes%20about%20four%20minutes.%20Wait%20for%20%2Fhealth%20before%20running%20the%20Super%20Agent%0Acheck.%20Don%27t%20enable%20Claude%20or%20Codex%20Engineer%20unless%20the%20owner%20asks.%0AKeep%20port%208000%20private%3A%20never%20run%20share%20set-public%2C%20and%20never%20switch%20to%0Acompose.prod.yaml%20without%20a%20JWT%20key%20from%20the%20owner.%20Finish%20by%20giving%20the%0Aowner%20the%20%60ssh%20-N%20-L%207777%3Alocalhost%3A8000%20%3Cvm%3E.exe.xyz%60%20command%20and%20the%0Asteps%20in%20%22Open%20the%20AgentOS%20UI%22%2C%20using%20this%20VM%27s%20name.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/agno-agentos/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Agno AgentOS on this VM by following the exe.dev recipe at https://exe.dev/deploy/agno-agentos.md from top to bottom.\n\nThe recipe's example VM name is my-agentos. This VM's name is the output of `hostname`: use it wherever the recipe writes my-agentos. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- AgentOS and PostgreSQL with pgvector in Docker Compose in ~/agentos, back after a reboot\n- Super Agent answering through exe.dev's LLM integration, with no OpenAI or Anthropic key on the VM\n- Port 8000 private behind exe.dev login, answering /health\n- A generated database password in ~/agentos/.env, mode 600\n- A nightly pg_dump of the database in ~/backups\n\nRun \"Set up AgentOS by hand\" from \"On the VM\", skipping VM creation and\nSSH, then the backup commands in \"Back up and restore\". The first build\ntakes about four minutes. Wait for /health before running the Super Agent\ncheck. Don't enable Claude or Codex Engineer unless the owner asks.\nKeep port 8000 private: never run share set-public, and never switch to\ncompose.prod.yaml without a JWT key from the owner. Finish by giving the\nowner the `ssh -N -L 7777:localhost:8000 \u003cvm\u003e.exe.xyz` command and the\nsteps in \"Open the AgentOS UI\", using this VM's name.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe.dev/deploy/agno-agentos/prompt.txt"
  },
  "updated": "2026-11-16",
  "verified": "2026-11-16",
  "related": [
    "postgres",
    "mastra",
    "openai-agents-sdk",
    "claude-code",
    "codex",
    "agents"
  ],
  "alternatives": [
    "Railway",
    "AWS",
    "Google Cloud",
    "E2B"
  ]
}
