TURNKEYGNU / LINUX
English

Ready-to-use server

Odoo

From ERP to CRM, eCommerce to CMS

Business managementCRMERPInvoicingPythonContent managementEcommerce
Odoo - AppsOdoo - Apps Odoo - EcommerceOdoo - Ecommerce Odoo - MessengerOdoo - Messenger

Odoo is an all-in-one business management suite of mobile-friendly web apps that integrates everything you need to grow your business: CRM, website content management, project management, human resources, accounting, invoicing and more. Odoo apps integrate seamlessly to provide a full-featured open source ERP, but can also be used stand-alone. Python programmers can develop their own app modules, or choose from an array of free open source such as those provided by OCA; or paid commercial ones.

This appliance includes all the standard features in TurnKey Core:

  • Odoo configurations for TurnKey v18.x:

    • Odoo v16 installed from debian backports apt repo (v18.x).

    • Includes modules from base install of Odoo.

  • Security note: As of 18.0, due to using the debian backports repo Updates to Odoo ARE NOT configured to install automatically.

  • SSL support out of the box.

  • Adminer administration frontend for PostgreSQL (listening on port 12322 - uses SSL).

  • Webmin modules for configuring Apache2, PostgreSQL and Postfix.

To create a new Odoo Databse (i.e. site)

To create a new Odoo DB, the Odoo config file needs to be edited and the Odoo service restarted.

Overview of process:

  1. Edit /etc/odoo/odoo

    • change value of "db_name" from "TurnkeylinuxExample" to your desired DB name

  2. Restart odoo.service

  3. Reload Odoo login screen in your browser and you should be good to go

Webmin steps:

    • Browse to 'Tools' >> 'FileManager'

    • Navigate to '/etc/odoo' and edit the 'odoo.conf' file

    • Edit as per step 1 above

    • Save changes

    • Navigate to 'System' >> 'Bootup and Shutdown'

    • Find the "odoo.service" in the list and select it via the checkbox

    • Scroll to the bottom and select 'Restart'

    • As per step 3 above

CLI steps:

    • Edit /etc/odoo/odoo as per step 1

    • Restart odoo.service:

      systemctl restart odoo

    • As per step 3 above

Notice for special Odoo Localization

In case you run a L10n Odoo Localization you will need other PIP Packages and Libs installed on your system, please check your localization support on OCA.

Credentials (passwords set at first boot)

Note: the Odoo password set at firstboot applies to both the Odoo admin account (example app) AND the masterpassword - however these can be changed individually after firstboot.

  • Webmin, SSH: username root

  • PostgreSQL, Adminer: username postgres

  • Odoo Master Account: admin

Usage details & Logging in for Administration

  • Odoo Master Account: admin

No default passwords: For security reasons there are no default passwords. All passwords are set at system initialization time.

Ignore SSL browser warning: browsers don't like self-signed SSL certificates, but this is the only kind that can be generated automatically. If you have a domain configured, then via Confconsole Advanced menu, you can generate free Let's Encypt SSL/TLS certificates.

Web - point your browser at either:

  1. http://12.34.56.789/ - not encrypted so no browser warning
  2. https://12.34.56.789/ - encrypted with self-signed SSL certificate

Username for database administration:

Login as PostgreSQL username postgres at

  1. https://12.34.56.789:12322/ - Adminer database management web app
  2. PostgreSQL command line tool:
    $ psql -U postgres -h localhost
Password for user postgres:
Type "help" for help.

postgres=#

Username for OS system administration:

Login as root except on AWS marketplace which uses username admin.

  1. Point your browser to:
  2. Login with SSH client:
    ssh root@12.34.56.789

    Special case for AWS marketplace:

    ssh admin@12.34.56.789

* Replace 12.34.56.789 with a valid IP or hostname.

Documentation

The TKL Odoo Appliance has been released  in TurnkeyLinux versions 14.0 and 14.2 which implement Odoo Version 8.0.

General Operations instructions are staight forward.

  • Install the App
  • Keep track of your User Names and Passwords
  • Open the Ap (Odoo)
  • Install the Database with your preset admin password
  • Install a Few Modules
  • Go to "Settings/Users" and update your password for Admin.

 I like to even change the Admin user name to my own.

  • Set up your Company Data
  • Set up your Incoming Server (outgoing works at first build with LocalHost)
  • Explore Away

Log Out

Go to Database Manager.  Make a Backup (so you know how to do it)

Log In, explore, add some more modules.

Additional Modules:

Once you get the basic hang of things you can consider adding additional Modules to the standard Odoo Build.  One great source for additional modules is the Odoo Community Association  https://github.com/oca  .  To install a module you will need to enter the Shell (port 12320) or Webmin and migrate to your /opt/openerp directory.  It is recomended that you declare a New Directiory (in this case OCA) as /opt/openerp/oca .

Branches:

It is CRITICAL that you work in the 8.0 BRANCH with the TKL ODOO App.  Any "git clone" line needs to end with "-b 8.0" .  You can verify this by navigating to the Directory and issuing the "git branch" command.  This will tell you which branch is being pulled to that directory.

Having done so you can issue "git clone" commands from the /opt/openerp/oca directory which will stack your modules in an organized and SEPARATE manner from the Odoo /Addons themselves.

Addons Path: 

You will need next to go to your /etc/odoo/openerp-server.conf file and change the "addons" path to include EACH of the Additional Folders you have put in via your Git Clone Command.  If using OCA, you should not simply declare /OCA  but rather /opt/openerp/oca/module1,/opt/openerp/oca/module2 (etc).  You need to have a comma after each directory (starting with the default" /opt/openerp/odoo/addons,".  There should not be a "space" after the comma.  Your LAST DIRECTORY should not have a  Comma after it however.  All of the Addon directories need to be on ONE LINE.

 Editing openerp-server.conf:

Best to build this lin in NotePad or similar basic text editor then paste it into place.  (The WebMin Text Editor is easiest.  The WebMin File Manager also works well, but you need a Java Enabled Browser to use it - so not CHROME).

Once added to the openerp-server.conf file you should either restart your Server or Restart your Odoo Service.  Log in again.  Go to Settings, Local Modules.  Choose "Update Modules List".  If you have done the above correctly your new modules will be available to you.

Do note that Each OCA Repository often hosts Several Modules, so you will want to search for the Module by the specific name rather than the repository name.

Keep track of yourself.  

Note also that once you "add a module" it will generally stay, as a name, in your Odoo Module list, even if you remove the directory itself.

Git Pulls:

You can UPDATE Odoo as well as OCA (etc) modules by using the GIT PULL command in specific directories.  Navigating to the directory and issuing "git status" command.

We do not recomend actively "git pulling" unless you have functional and usable backup protocols in place.

(work in progress - draft 4 touch)