Northstar · Setup guide

Français

Northstar for Odoo.sh

We load Northstar into an empty Odoo 20 database of yours on Odoo.sh, then add a new business day every night.

Your setup
About 5 minutes.
Northstar ready in
About 40 minutes. It loads in the background: you can close the page, and we email you when it is done.

Quick start

  1. Create an empty Odoo 20 database
    On Odoo.sh, create a new Odoo 20 database. Choose United States as the country and leave out the demo data. Leave it empty.
  2. Create an API key
    In your new Odoo, log in as an administrator. Click your avatar, My Profile, Account Security, New API Key. Name it Northstar, choose Scope RPC and Expires Never (Northstar uses it every night). Copy it now: Odoo shows it only once.
  3. Paste the address and the key on our page
    Sign in (it is free) and open our Northstar page. Paste your Odoo address and the key, click Load Northstar, then Start the load. You can close the page: we email you when it is done.
Keep the key secret. It belongs to an administrator of your Odoo. When you no longer need Northstar, disconnect it and delete the key in Odoo: see How to disconnect below.
Need more detail?

Which Odoo can take it

  • Works: an Odoo 20 database on Odoo.sh, reachable from the internet at its https address.
  • Does not work: an Odoo on your own computer only. Use the download instead: it is free.

You need a free sign-in. If Odoo blocks external access on your plan, we'll tell you clearly.

Create the database, in detail

  1. Create a new database in your Odoo.sh project on an Odoo 20 branch. Set the country to United States and leave out the demo data. Northstar needs a company in the United States, in US dollars, with the US chart of accounts.
  2. Leave it empty. Do not add customers, products or documents, and do not install apps: Northstar installs every app it needs.
  3. Note the https address of your Odoo, as you see it in your browser.
Northstar only loads into an empty database. It never changes or deletes the records you create. If something needs fixing, our page tells you in plain words.

Create the API key, in detail

  1. In your new Odoo, log in as an administrator. Northstar installs apps, so the key must belong to an administrator.
  2. Click your avatar, open your profile, then Account Security and New API Key. Turn on developer mode if you do not see it.
  3. Name the key Northstar. Choose Scope RPC and Expires Never (Northstar uses it every night).
  4. Copy the key right away: Odoo shows it only once. Keep it secret.
If the key expires or is revoked, Northstar stops adding days. Create a new key in Odoo, then use Replace the key on our Northstar page.

Give us the address and the key, in detail

  1. Sign in (it is free) and open our Northstar page.
  2. On the page, choose Odoo.sh or my own server and fill in the Odoo address (the https address), the Database name (on Odoo Online we read it from the address, and Change lets you type another) and the Administrator API key. We keep the key encrypted. It is never shown again.
  3. The box to keep the key is ticked: we keep it encrypted for 14 days at most, so you can connect Northstar to your AI apps in one click when the load is done. Untick it if you prefer.
  4. Click Load Northstar. If something needs fixing, we say what in plain words.
  5. Click Start the load. An optional question asks what you will use Northstar for: skip it if you like.

The wait

  • How long: about 40 minutes.
  • It runs in the background. You can close the page: we email you when it is done.
  • Progress: the page shows a percentage.
  • If it stops: click Start again. It continues where it stopped. Do not switch the key off during a load.

After the load

  • Open your Odoo: Northstar's year of business is there. Each night, we add the day that just ended. Today is always empty.
  • If nobody uses it for 30 days, it pauses. Signing in to that Odoo or asking a question about it keeps it going. One click on Resume brings it back.
  • Repair puts the settings, products, customers, suppliers and taxes back as they were loaded. First we list what differs, then you confirm. History, stock and documents are not touched.
  • To ask questions about your own copy, connect it to the web chat, ChatGPT or Claude in one click on our Northstar page.

What we keep and what we erase

  • While you are connected, we keep your key (encrypted), your Odoo address and your database name.
  • When you disconnect, we erase them at once.
  • We keep no copy of what is in your database. The data Northstar wrote stays in your Odoo.

How to disconnect

  1. Open our Northstar page and click Disconnect. Confirm.
  2. We erase the key, the address and the database name at once, and no new day is added. If you connected Northstar to your AI apps, that connection is archived at the same time. Your conversations stay.
  3. Revoke the key in Odoo too: only you can do that. In Odoo, open your profile, then Account Security, and delete the key.

Questions? Write to contact@speaktoyourdatabase.com.

Need help? Contact support