erplibre/README.md

# ERPLibre

ERPLibre is a CRM/ERP platform including automated installation, maintenance, and development of open source modules of
the Odoo community version. It is a "soft-fork" of the Odoo Community Edition (OCE), meaning it aims at contributing back
upstream.
It is based on a set of production-ready modules, supported by the Odoo Community Association (OCA) and an
ecosystem of specialized companies. This solution ensures digital sovereignty in a local environment while integrating
pre-trained Generative Transformers (GPT), bringing an additional dimension to data management and automation.

Follow us on Mastodon : https://fosstodon.org/@erplibre

# Installation

Select a guide to install your environment.

## Easy install on Ubuntu or Debian using Docker

This has been tested in Debian 12 and Ubuntu 24.04 LTS.

**Note** : This is meant for a test environment, on a local network or similar environment not directly exposed to the Internet.

1. Make sure Docker and nginx web server are installed:<BR>
```sudo apt install docker docker-compose nginx```
1. Get the latest ERPLibre Docker compose file:<BR>
```wget https://raw.githubusercontent.com/ERPLibre/ERPLibre/v1.6.0/docker-compose.yml```
1. Install and run ERPLibre with Docker running as a daemon (web server):<BR>
```sudo docker-compose up -d```
1. Open the final installation step at this web page :<BR>
```http://[server IP]:8069```<BR>
![Capture du 2024-11-05 08-34-45](https://github.com/user-attachments/assets/7c6295b6-cc95-462d-822c-3ff72b772155)
1. Finish the installation by providing a database name, email and password. then click on **Create Database**. Depending on your system resources **this may take more than 2 minutes without feedback !** Check your browser loading indicator.
1. Next, the web page will reload itself, and you should see the Applications list in ERPLibre:<BR>
![2024-11-05_09-54](https://github.com/user-attachments/assets/1742c4a9-da96-466b-9c17-35eb5ca786ff)
You can now personalize your ERPLibre installation.

For more information, read [Docker guide](./docker/README.md).

## Install from source code

Into Ubuntu, minimal dependency:

```bash
sudo apt install make git curl
```

Into Ubuntu, developer dependency:

```bash
sudo apt install make build-essential libssl-dev zlib1g-dev libreadline-dev libsqlite3-dev curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev liblzma-dev libbz2-dev libldap2-dev libsasl2-dev
```

Clone the project:

```bash
git clone https://github.com/ERPLibre/ERPLibre.git
cd ERPLibre
```

Support Ubuntu 20.04, 22.04, 24.04 and OSX. The installation duration is more than 30 minutes.

```bash
make install_os
make install_odoo_16
```

Update your configuration if you need to run from another interface than 127.0.0.1, file `config.conf`

```
xmlrpc_interface = 0.0.0.0
```

Show version :

```bash
make version
```

Ready to execute:

```bash
make run
```


## Discover guide

[Guide to run ERPLibre in discover to learn it](./doc/DISCOVER.md).

## Production guide

[Guide to run ERPLibre in production server](./doc/PRODUCTION.md).

## Development guide

[Guide to run ERPLibre in development environment](./doc/DEVELOPMENT.md).

### Pycharm

First open

```bash
make pycharm_open
```

Close it, and configure

```bash
make pycharm_configure
```

Open it

```bash
make pycharm_open
```

# Execution

[Guide to run ERPLibre with different case](./doc/RUN.md).

# git-repo

To change repository like addons, see [GIT_REPO.md](doc/GIT_REPO.md)

# Test

Execute ERPLibre test with his code generator.

```bash
time make test_full_fast
```