{
  "manifest_version": "1",
  "slug": "odoo",
  "title": "Odoo",
  "headline": "Self-host Odoo Community",
  "description": "Self-host Odoo Community 20 with Docker on an exe.dev VM: CRM, Sales and Invoicing behind exe.dev login, a customer portal when you want one, and nightly backups.",
  "category": "productivity",
  "tags": [
    "odoo",
    "erp",
    "crm",
    "invoicing",
    "accounting",
    "docker compose",
    "postgres",
    "odoo community",
    "odoo docker",
    "odoo self-hosted"
  ],
  "url": "https://exe.dev/deploy/odoo",
  "markdown_url": "https://exe.dev/deploy/odoo.md",
  "upstream": {
    "website": "https://www.odoo.com/",
    "source": "https://github.com/odoo/odoo",
    "docs": "https://www.odoo.com/documentation/20.0/",
    "license": "LGPL-3.0"
  },
  "example_vm_name": "my-odoo",
  "time": "20 minutes",
  "stack": [
    {
      "name": "Odoo 20.0 Community",
      "detail": "The official odoo image in Docker Compose; three HTTP workers, cron, and a live-updates worker",
      "port": 8069,
      "data": "~/odoo/data"
    },
    {
      "name": "PostgreSQL 17",
      "detail": "postgres:17 in Docker Compose; Odoo connects as its own role, not a superuser",
      "data": "~/odoo/postgres"
    },
    {
      "name": "nginx",
      "detail": "The front door; sends /websocket to Odoo's live-updates port 8072 and refuses the database manager",
      "port": 8000
    },
    {
      "name": "Nightly backup",
      "detail": "A systemd timer; Odoo's own dump of the database and files, plus settings and secrets, kept two weeks",
      "data": "~/odoo/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-odoo.exe.xyz/",
      "who": "private",
      "what": "Odoo, for you and the people you share the VM with, each with their own Odoo login"
    },
    {
      "url": "https://my-odoo.exe.xyz/my",
      "who": "public",
      "what": "Only if you open the VM up, for the customer portal and quotation links"
    }
  ],
  "inputs": [
    {
      "name": "ODOO_COUNTRY",
      "description": "Your company's two-letter country code (US, GB, DE, ...); it sets the currency, and the taxes and chart of accounts Invoicing installs"
    }
  ],
  "delivers": [
    "Odoo 20.0 Community on PostgreSQL 17, behind exe.dev login, that starts again after a reboot.",
    "An administrator login for your email, with a random password kept in a file on the VM.",
    "The database manager switched off and refused, under a hashed master password.",
    "Live updates (chat, notifications) working through exe.dev's HTTPS proxy.",
    "Styled PDF quotes and invoices, even while the VM is private.",
    "Nightly backups of the database and files, with one restored into a scratch database."
  ],
  "owner_runs_after": [
    "ssh my-odoo.exe.xyz cat odoo/admin-password"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=ODOO_COUNTRY%3D%3Cfill-this-in%3E%0A%0ASet%20up%20Odoo%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fodoo.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20values%20at%20the%20top%20of%20this%20message%20are%20mine%3A%0A-%20ODOO_COUNTRY%3A%20Your%20company%27s%20two-letter%20country%20code%20%28US%2C%20GB%2C%20DE%2C%20...%29%3B%20it%20sets%20the%20currency%2C%20and%20the%20taxes%20and%20chart%20of%20accounts%20Invoicing%20installs%0AAsk%20me%20for%20any%20that%20still%20say%20%3Cfill-this-in%3E%20before%20you%20need%20them.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-odoo.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-odoo.%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-%20Odoo%2020.0%20Community%20on%20PostgreSQL%2017%2C%20behind%20exe.dev%20login%2C%20that%20starts%20again%20after%20a%20reboot.%0A-%20An%20administrator%20login%20for%20your%20email%2C%20with%20a%20random%20password%20kept%20in%20a%20file%20on%20the%20VM.%0A-%20The%20database%20manager%20switched%20off%20and%20refused%2C%20under%20a%20hashed%20master%20password.%0A-%20Live%20updates%20%28chat%2C%20notifications%29%20working%20through%20exe.dev%27s%20HTTPS%20proxy.%0A-%20Styled%20PDF%20quotes%20and%20invoices%2C%20even%20while%20the%20VM%20is%20private.%0A-%20Nightly%20backups%20of%20the%20database%20and%20files%2C%20with%20one%20restored%20into%20a%20scratch%20database.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20from%20top%20to%20bottom%2C%20skipping%20VM%20creation%3A%20Docker%2C%0Athe%20passwords%2C%20the%20settings%20and%20Compose%20files%2C%20the%20database%2C%20nginx%2C%20the%0Abackup%20timer%2C%20and%20the%20backup%20test.%20The%20walkthrough%20at%20the%20top%20is%20for%20the%0Aowner%20afterwards.%0AWork%20as%20exedev%20in%20~%2Fodoo.%20Never%20overwrite%20an%20existing%20.env%2C%0Aadmin-password%20or%20master-password%2C%20and%20don%27t%20run%20%60odoo%20db%20init%60%20if%20the%0Aodoo%20database%20already%20exists.%20The%20administrator%20login%20is%20the%20owner%27s%0Aemail%20from%20the%20reflection%20integration%3B%20if%20that%27s%20empty%2C%20ask%20the%20owner.%0AAsk%20for%20the%20country%20code%20if%20you%20weren%27t%20given%20one.%0ADon%27t%20activate%20apps%2C%20create%20users%2C%20set%20up%20email%2C%20or%20make%20the%20VM%20public%3B%0Adon%27t%20run%20Restore%20or%20Update.%20Verify%20docker.service%20is%20enabled%2C%20%2Fweb%2Fhealth%0Aanswers%20%60pass%60%20on%20localhost%3A8000%2C%20%2Fweb%2Fdatabase%2Fmanager%20is%20a%20404%20there%2C%0A%2Fweb%2Fsignup%20is%20a%20404%2C%20the%20backup%20timer%20is%20enabled%20and%20the%20backup%20test%0Apasses.%20Do%20not%20reboot.%0ANever%20paste%20a%20password%20into%20the%20chat%3B%20say%20it%27s%20in%20~%2Fodoo%2Fadmin-password.%0AFinish%20by%20pointing%20the%20owner%20to%20%22Sign%20in%22%20and%20%22Activate%20your%20apps%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open%20and%20these%20commands%2C%20which%20only%20I%20can%20run%2C%20from%20my%20own%20computer%20%28with%20this%20VM%27s%20name%20in%20them%29%3A%0A%20%20ssh%20my-odoo.exe.xyz%20cat%20odoo%2Fadmin-password%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/odoo/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "ODOO_COUNTRY=\u003cfill-this-in\u003e\n\nSet up Odoo on this VM by following the exe.dev recipe at https://exe.dev/deploy/odoo.md?via=deploy from top to bottom.\n\nThe values at the top of this message are mine:\n- ODOO_COUNTRY: Your company's two-letter country code (US, GB, DE, ...); it sets the currency, and the taxes and chart of accounts Invoicing installs\nAsk me for any that still say \u003cfill-this-in\u003e before you need them.\n\nThe recipe's example VM name is my-odoo. This VM's name is the output of `hostname`: use it wherever the recipe writes my-odoo. 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- Odoo 20.0 Community on PostgreSQL 17, behind exe.dev login, that starts again after a reboot.\n- An administrator login for your email, with a random password kept in a file on the VM.\n- The database manager switched off and refused, under a hashed master password.\n- Live updates (chat, notifications) working through exe.dev's HTTPS proxy.\n- Styled PDF quotes and invoices, even while the VM is private.\n- Nightly backups of the database and files, with one restored into a scratch database.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" from top to bottom, skipping VM creation: Docker,\nthe passwords, the settings and Compose files, the database, nginx, the\nbackup timer, and the backup test. The walkthrough at the top is for the\nowner afterwards.\nWork as exedev in ~/odoo. Never overwrite an existing .env,\nadmin-password or master-password, and don't run `odoo db init` if the\nodoo database already exists. The administrator login is the owner's\nemail from the reflection integration; if that's empty, ask the owner.\nAsk for the country code if you weren't given one.\nDon't activate apps, create users, set up email, or make the VM public;\ndon't run Restore or Update. Verify docker.service is enabled, /web/health\nanswers `pass` on localhost:8000, /web/database/manager is a 404 there,\n/web/signup is a 404, the backup timer is enabled and the backup test\npasses. Do not reboot.\nNever paste a password into the chat; say it's in ~/odoo/admin-password.\nFinish by pointing the owner to \"Sign in\" and \"Activate your apps\".\n\nFinish with the URLs I should open and these commands, which only I can run, from my own computer (with this VM's name in them):\n  ssh my-odoo.exe.xyz cat odoo/admin-password\n",
    "prompt_url": "https://exe.dev/deploy/odoo/prompt.txt"
  },
  "published": "2026-11-21",
  "updated": "2026-11-20",
  "verified": "2026-11-20",
  "related": [
    "postgres",
    "docker-compose",
    "chatwoot",
    "metabase",
    "openproject",
    "cal-diy"
  ],
  "alternatives": [
    "Odoo Online",
    "ERPNext",
    "Dolibarr",
    "Zoho One",
    "HubSpot"
  ]
}
