Ibel

A suite of open source business apps!
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About Ibel
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgements

About Ibel

Ibel is a suite of web based open source business apps.

The main Ibel Apps include an Open Source CRM, Website Builder, eCommerce, Warehouse Management, Project Management, Billing & Accounting, Point of Sale, Human Resources, purchase, Manufacturing, ...

Ibel 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.

Built With

Ibel is a new Odoo distribution created by Ibel technology from Odoo Community Backport (OCB) and a collection of open source community modules gathered in the ibel_addons repository. These add-ons improve the user interface and fill in the features missing in Odoo community edition. Ibel even adds features that do not exist in Odoo enterprise.

Ibel therefore wants to be a 100% open source alternative to Odoo enterprise.

• ibel
• ibel_addons

Getting Started

Manual installation

Prerequisites

It is highly recommended to use the Linux Ubuntu operating system for the installation of Ibel, since this is the operating system that Odoo uses for all its tests, debugging, and installations , in addition to the fact that most developers of Odoo also use GNU/Linux distributions, and is much more likely to get support from the Odoo community for OS-level issues that occur in GNU/Linux than Windows or macOS.

Run the following commands to install essentiel tools:

$ sudo apt update
$ sudo apt install git gdebi wget build-essential

Configure Git & fetch the source

Install & configure Git

The very first step of the installation process is to install the git version control system because the Ibel source code is managed on GitHub. Once installed, you can set your name and email:

   $ git config --global user.name "Your full name"
   $ git config --global user.email "[email protected]"

Fetch the sources

All the Odoo sources will be located in $HOME

   $ cd -
   $ git clone https://github.com/Ibel-technology/ibel.git -b 14.0 --single-branch --depth 1
   $ git clone https://github.com/Ibel-technology/ibel_addons.git -b 14.0 --single-branch --depth 1

Install the dependencies

Install wkhtmltopdf

wkhtmltopdf is a library to render HTML into PDF. Ibel uses it to create PDF reports. wkhtmltopdf is not installed through pip and must be installed manually in version 0.12.5 to support headers and footers.

   $ sudo apt install gdebi
   $ cd /tmp/
   $ sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.focal_amd64.deb
   $ sudo gdebi --n wkhtmltox_0.12.5-1.focal_amd64.deb
   $ sudo ln -s /usr/local/bin/wkhtmltopdf /usr/bin
   $ sudo ln -s /usr/local/bin/wkhtmltoimage /usr/bin

Right-to-left interface support

In order to support right-to-left (RTL) languages, we need rtlcss to convert the CSS files:

   $ sudo apt-get install nodejs npm
   $ sudo npm install -g rtlcss

Install Postgresql

Ibel uses PostgreSQL as database management system. Use your package manager to download and install PostgreSQL (supported version: 10.0 and later).

On Debian/Unbuntu, it can be achieved by executing the following:

   $ sudo apt install postgresql postgresql-client

By default, the only user is postgres but Ibel forbids connecting as postgres, so you need to create a new PostgreSQL user:

   $ sudo -u postgres createuser -s $USER
   $ createdb $USER

Note: Because your PostgreSQL user has the same name as your Unix login, you will be able to connect to the database without password.

Python

Odoo requires Python 3.6 or later, if your computer is up-to-date you should already be at this version or higher.

You can check your Python version with:

   $ python3 --version

Install pip3 and libraries

For libraries using native code, installation of development tools and native dependencies is required before installing the Python dependencies of Ibel.

   $ sudo apt install python3-pip python3-dev python3-venv libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev libssl-dev libpq-dev libjpeg-dev

Create python virtual environments

It can be preferable to not mix python modules packages between different instances of Odoo or with your system. You can use virtualenv to create isolated Python environments.

   $ python3 -m venv ibel-env 

This will create the ibel-env directory if it doesn’t exist, and also create directories inside it containing a copy of the Python interpreter, the standard library, and various supporting files.

Once you’ve created a virtual environment, you may activate it.

   $ source ibel-env/bin/activate 

Activating the virtual environment will change your shell’s prompt to show what virtual environment you’re using, and modify the environment so that running python will get you that particular version and installation of Python.

   (ibel-env) $ 

Install Ibel requirements in virtual env

   (ibel-env) $ pip3 install setuptools wheel
   (ibel-env) $ pip3 install -r ibel/requirements.txt

Run the server

Running odoo-bin

Once all dependencies are set up, Ibel can be launched by running odoo-bin, the command-line interface of the server.

1. To generate a configuration file for your Ibel instance, run the following command:

   (ibel-env) $ python3 ibel/odoo-bin --config ibel.conf --addons-path ibel/addons,ibel_addons --save --stop-after-init

You can add additional options, and their values will be saved in the generated file. All the unset options will be saved with their default value set. To get a list of possible options, use the following command:

   (ibel-env) $ python3 ibel/odoo-bin --help

This will provide you with some help about what the various options perform.

Also refer to the Reference cmdline server

2. Then, to start the server with the saved options, run the following command:

   (ibel-env) $ python3 ibel/odoo-bin --config ibel.conf --database mydb

mydb is the name of database that is going to be used.

Log in to Ibel

Open http://localhost:8069/ on your browser. We recommend you use: Firefox, Chrome (Chromium the open source equivalent) or any other browser with development tools.

To log in as the administrator user, you can use the following credentials: email = admin password = admin

Containerized Installation

See hub.docker.com/r/ibeltechnology/ibel

Usage

Please refer to the user documentation

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the GNU LESSER GENERAL PUBLIC LICENSE, Version 3 (LGPLv3). See Licence` for more information.

Contact

Abdourahmane Wone - https://github.com/abdawone - [email protected]

Project Link: https://ibel.app

Acknowledgements