# Install Odoo - Open Source Business Application Suite - on Windows

## What is Odoo?

> Odoo is a suite of web based open source business apps. The main Odoo Apps include an Open Source CRM, Website Builder, eCommerce, Warehouse Management, Project Management, Billing & Accounting, Point of Sale, Human Resources, Marketing, Manufacturing. Odoo Apps can be used as stand-alone applications, but they also integrate seamlessly so you get a full-featured Open Source ERP when you install several Apps. - https://github.com/odoo/odoo

## Installation

1. Log into the Windows device
2. Download Odoo Download
3. Download Python Download
4. Download PostgreSQL Download
5. Download Visual Studio Build Tools Download
6. Run the downloaded PostgreSQL installer, accepting all the defaults
7. When prompted, enter and confirm a superuser password
8. Run the downloaded Python installer, making sure to check the option to add Python to the path
9. Run the downloaded VS Build Tools installer
10. Select Individual components from the top left > Filter the list to C++ x64/x86 build tools > Check the box next to the option for x64/x86 build tools (Latest)
11. Filter the list to Windows SDK > Check the box next to the option for the latest Windows SDK > Click Install at the bottom right
12. Once the installation completes close VS Build Tools installer
13. Extract the downloaded Odoo .zip archive
14. Rename the extracted folder to Odoo
15. Cut the Odoo folder to a location it can safely run from, C:\Program Files\Odoo in this example
16. Navigate into the Odoo folder > Right click in the white space > New > Text Document
17. Name the new file odoo.conf then edit it in a text editor
18. Paste the following configuration into odoo.conf

    [options]
    db_user = odoo_rw
    db_password = 0dooDB_rw$
    db_name = odoo
    db_host = localhost

19. Save the changes to odoo.conf
20. Back in the Odoo folder, hold the SHIFT key and right click in the white space > Open PowerShell window here...
21. Run the following commands in PowerShell
    # connect to postgres
    &'C:\Program Files\PostgreSQL\16\bin\psql.exe' -U postgres
    # enter the postgres seperuser password set during installation
    # create odoo database user
    create user odoo_rw with password '0dooDB_rw$';
    # create odoo database
    create database odoo with encoding='UTF8' template='template0' owner='odoo_rw';
    # close postgresql connection
    exit
    # prepare and activate the virtual environment
    python -m venv .\odoo-venv
    .\odoo-venv\Scripts\activate
    # install wheel
    pip3 install wheel
    # install setuptools
    pip install --upgrade setuptools
    # install odoo
    pip install -r requirements.txt
    # run odoo
    python .\odoo-bin --config .\odoo.conf -i base
22. Open a web browser and navigate to http://DNSorIP:8069
23. Login with the username admin and password admin
24. Click the user icon at the top right corner of the screen > Preferences
25. Update the Email and Email Signature > Click Save
26. Click the Account Security tab > Click the Change Password button
27. Enter admin as the current password > Click Confirm Password
28. Enter and confirm a new password > Click Change Password
29. Login using the updated email address and password
30. Welcome to Odoo

## Run Odoo on System Startup (Optional, but recommended)

1. Press CTRL + C to kill the running Odoo process
2. Open a text editor and paste the following

   :: Start Odoo server
   cd /D "%~dp0"
   start "odoo" /b python .\odoo-bin --config .\odoo.conf

3. Save the file as odoo.bat in the Odoo directory, C:\Program Files\Odoo in this example
4. Click on the Start Button > Type task > Launch Task Scheduler
5. Right click the Task Scheduler Library folder in the left pane > Create Basic Task...
6. Set the name to Odoo and optionally set a Description > Click Next
7. For the Trigger, select When the computer starts > Click Next
8. For the Action, select Start a program > Click Next
9. Complete the form fields as follows:

   Program/script: "%ProgramFiles%\Odoo\odoo.bat"
   Add arguments:
   Start in: "%ProgramFiles%\Odoo"

10. Click Next
11. Check the Open the Properties dialog checkbox > Click Finish
12. In the Properties dialog, click the Change User or Group... button
13. Type System in the Object name field > Click OK
14. Check the Run with highest privileges box
15. Click OK to create the scheduled task
16. Right click the Odoo task > Run
17. Refresh the open web browser to verify Odoo is now running from the scheduled task

Source: https://www.odoo.com/documentation/17.0/administration/on_premise/source.html