127 lines
4.7 KiB
Markdown
127 lines
4.7 KiB
Markdown
|
||
This repository contains the modules for Slink, which includes functionality for managing Sales,I&C,Inventory and inside Sales. This `README.md` provides instructions for installing Odoo 17 on a Linux (Ubuntu/Debian) to set up the environment needed to use this module.
|
||
|
||
## Prerequisites
|
||
|
||
Before installing Odoo 17, ensure your system meets the following requirements:
|
||
|
||
- **Operating System**: Ubuntu 20.04/22.04 LTS (Linux) or Windows 10/11
|
||
- **Python**: Python 3.10 or later
|
||
- **PostgreSQL**: Version 12.0 or later
|
||
- **Git**: For cloning the Odoo source code and this module
|
||
- **Node.js**: For JavaScript dependencies
|
||
- **wkhtmltopdf**: Version 0.12.6 for PDF rendering
|
||
- **Hardware**: Minimum 4GB RAM, multi-core CPU, 10GB free disk space
|
||
- **Internet Connection**: For downloading dependencies and source code
|
||
|
||
## Installation Steps
|
||
|
||
### Option 1: Installing Odoo 17 on Ubuntu/Debian
|
||
|
||
1. **Update the System**
|
||
Ensure your system is up-to-date:
|
||
```bash
|
||
sudo apt update && sudo apt upgrade -y
|
||
```
|
||
|
||
2. **Install Dependencies**
|
||
Install required system packages, Python, and PostgreSQL:
|
||
```bash
|
||
sudo apt install -y git python3 python3-pip python3-venv python3-dev libpq-dev \
|
||
build-essential wget libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev \
|
||
libffi-dev libjpeg-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev \
|
||
libharfbuzz-dev libfribidi-dev libxcb1-dev nodejs npm
|
||
```
|
||
|
||
3. **Install wkhtmltopdf**
|
||
Download and install wkhtmltopdf for PDF rendering:
|
||
```bash
|
||
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb
|
||
sudo dpkg -i wkhtmltox_0.12.6.1-3.jammy_amd64.deb
|
||
sudo apt install -f
|
||
```
|
||
|
||
4. **Install PostgreSQL**
|
||
Install and configure PostgreSQL:
|
||
```bash
|
||
sudo apt install -y postgresql
|
||
sudo systemctl start postgresql
|
||
sudo systemctl enable postgresql
|
||
```
|
||
Create a PostgreSQL user for Odoo:
|
||
```bash
|
||
sudo -u postgres createuser -d -R -S odoo
|
||
sudo -u postgres psql -c "ALTER USER odoo WITH PASSWORD 'odoo';"
|
||
```
|
||
|
||
5. **Clone Odoo Source Code**
|
||
Clone the Odoo 17 Community repository:
|
||
```bash
|
||
mkdir ~/odoo
|
||
cd ~/odoo
|
||
git clone --branch 17.0 https://github.com/odoo/odoo.git
|
||
```
|
||
|
||
6. **Set Up Python Virtual Environment**
|
||
Create and activate a virtual environment:
|
||
```bash
|
||
python3 -m venv ~/odoo/venv
|
||
source ~/odoo/venv/bin/activate
|
||
```
|
||
|
||
7. **Install Python Dependencies**
|
||
Install Odoo’s Python dependencies:
|
||
```bash
|
||
pip install --upgrade pip
|
||
pip install -r ~/odoo/odoo/requirements.txt
|
||
```
|
||
|
||
8. **Clone the SOS Inventory Module**
|
||
Clone this module into a custom addons directory:
|
||
```bash
|
||
mkdir ~/odoo/custom_addons
|
||
cd ~/odoo/custom_addons
|
||
git clone <your-repository-url> sos_inventory
|
||
```
|
||
|
||
9. **Configure Odoo**
|
||
Create an Odoo configuration file (`odoo.conf`):
|
||
```bash
|
||
nano ~/odoo/odoo.conf
|
||
```
|
||
Add the following content, adjusting paths and credentials as needed:
|
||
```ini
|
||
[options]
|
||
admin_passwd = your_secure_password
|
||
db_host = localhost
|
||
db_port = 5432
|
||
db_user = odoo
|
||
db_password = odoo
|
||
addons_path = /home/$USER/odoo/odoo/addons,/home/$USER/odoo/custom_addons
|
||
```
|
||
|
||
10. **Run Odoo**
|
||
Start the Odoo server:
|
||
```bash
|
||
cd ~/odoo
|
||
./venv/bin/python3 ./odoo/odoo-bin -c odoo.conf
|
||
```
|
||
|
||
11. **Access Odoo**
|
||
Open a web browser and navigate to `http://localhost:8069`. Follow the on-screen instructions to create a database and log in.
|
||
|
||
## Post-Installation
|
||
|
||
- **Install the SOS Inventory Module**: In the Odoo interface, go to `Apps`, search for `sos_inventory`, and install it.
|
||
- **Install the SOS Sales Module**: In the Odoo interface, go to `Apps`, search for `sos_sales`, and install it.
|
||
- **Install the SOS Inside Sales Module**: In the Odoo interface, go to `Apps`, search for `sos_inside_sales`, and install it.
|
||
- **Install the SOS I&C Module**: In the Odoo interface, go to `Apps`, search for `sos_installation_commision`, and install it.
|
||
- **Troubleshooting**: Check Odoo logs (`odoo.log`) for errors. Ensure PostgreSQL is running and the `odoo.conf` credentials match your PostgreSQL setup.
|
||
|
||
## Notes
|
||
|
||
- Replace `<your-repository-url>` with the actual URL of this repository.
|
||
- For production, consider running Odoo as a service and securing it with Nginx and HTTPS (refer to Odoo’s official documentation).
|
||
- For Odoo Enterprise, clone the Enterprise repository and add its path to `addons_path` in `odoo.conf`.
|
||
- Official Odoo documentation: [Odoo 17 Installation Guide](https://www.odoo.com/documentation/17.0/administration/install.html)[](https://www.odoo.com/documentation/18.0/administration/on_premise/source.html)
|
||
- If you encounter issues, consult the Odoo community forums or contact the module developers. |