dev-pack/makefile-installation.md

# Odoo and Lokavaluto addons installation
This document details the installation of Odoo 12.0 plus the addons created by Lokavaluto and available here: [https://github.com/Lokavaluto/lokavaluto-addons](https://github.com/Lokavaluto/lokavaluto-addons). In this installation, we use the branch ```12.0-Exchange_counters_2```. To use anther branch, just change the command in the MakeFile.

## Table of Contents
* [Make file](#Make%20file)
	* [Makefile content](#Makefile%20content)
	* [Installation](#Installation)
	* [Run Odoo](#Run%20Odoo)
* [Activate the developer mode](#Activate%20the%20developer%20mode)
* [Install the addons](#Install%20the%20addons)

## Make file
The Makefile is used to download Odoo 12.0 and all of its requirements.
To use it, the first step is to install make using ```sudo apt install make```.
It also requires bash ```sudo apt install bash```.

### Makefile content
The same Makefile is used to setup the environnement and to run.
For now you have to chose the version of Odoo carefully before launching the installation.
Once installed, you can not change easily Odoo's version.
So if you do not want to use the version 12.0 as Lokavaluto does, change it in the Makefile just after the comment ```Change Odoo's version here```.

For Lokavaluto's addons, you can chose the branch in the Makefile after the comment ```Change Addons' version here```. If you wan to change the branch after the installation, you can rerun the installation or switch branch in the git folder using ```git checkout branch_name``` 

```Makefile
.PHONY: odoo python3 pip3 postgre general-dependencies dependencies rtlcss addons run
SHELL := /bin/bash

install: odoo python3 pip3 postgre general-dependencies dependencies rtlcss addons
        @echo -e "Installation : ok \n"
 
.ONESHELL: 
odoo:
	@if [ ! -d "./odoo" ] ; then git clone https://github.com/odoo/odoo.git ; fi
	cd ./odoo
    # Change Odoo's version here
	git checkout 12.0
	sed -i 's/psycopg2==2.7.3.1/psycopg2==2.8.3/g' requirements.txt
	@echo -e "odoo download : ok \n"

python3:
	apt install -y python3
	@echo -e "python3 installation : ok \n"

pip3:
	apt install -y python3-pip
	@echo -e "pip3 installation : ok \n"

postgre:
	apt install -y postgresql postgresql-client
	sudo -u postgres createuser -s $$USER
	createdb $$USER
	@echo -e "postgre installation : ok \n"

general-dependencies:
	sudo apt install -y python3-dev libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev \
	libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev libfreetype6-dev \
	liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev libpq-dev

.ONESHELL:
dependencies:
	cd ./odoo;
	pip3 install setuptools wheel;
	pip3 install -r requirements.txt

rtlcss:
	apt install -y nodejs npm
	npm install -g postcss
	npm install -g rtlcss

.ONESHELL:
addons:
	@if [ ! -d "./lokavaluto-addons" ] ; then git clone https://github.com/Lokavaluto/lokavaluto-addons.git ; fi
	cd ./lokavaluto-addons
	# Change Addons' version here
	git checkout 12.0-Exchange_counters_2	
	@echo -e "Addons download : ok \n"

.ONESHELL:
run:
	cd ./odoo
	python3 odoo-bin --addons-path=addons,../lokavaluto-addons -d mydb
```

### Installation
Create the Makedile where you want to install the environnement.
After the installation, 2 folders are created ```lokavaluto-addons``` and ```odoo``` containing respectively Lokavaluto's addons and Odoo's source files. The script installs the latest version of Python3, pip3, and postgresql. It also downloads all the dependencies listed here: [https://www.odoo.com/documentation/12.0/setup/install.html#id7](https://www.odoo.com/documentation/12.0/setup/install.html#id7).

To start the installation, just run ```sudo make install```.


### Run Odoo
To launch Odoo, run ```sudo make run```.
This calls a python command inside odoo's folder ```python3 odoo-bin --addons-path=addons,../lokavaluto-addons -d mydb```.
The arguments ```--addons-path``` adds the defaults addons folder from Odoo 12.0 and the Lokavakuto's addons downloaded during the installation.

Everything should be running without errors nor warnings.

The WEB interface should be available at [http://localhost:8069](http://localhost:8069). You can login using the user ```admin``` and the password ```admin```.

## Activate the developer mode
Login using the user ```admin``` and the password ```admin``` and go to ```Settings``` to activate the ```developer mode```.

![settings](images/settings.png)

![dev](images/dev.png)

## Install the addons
Go to the ```Apps``` window and remove what is present in the ```Search``` field.

![remove](images/remove.png)

Then search for your module.

![search](images/search.png)

Install it by clicking on the ```Install Button``` 

![install](images/install.png)

Wait for the module to install and check the result.

![result](images/result.png)