Go to file
Deena 611cb5e418 Reference #9 2025-08-11 16:26:29 +05:30
dms Reference for #5 and #1 2025-08-04 15:29:56 +05:30
sos_dashboard First Commit 2025-07-23 09:25:42 +05:30
sos_inside_sales Reference for #6 2025-08-06 10:49:58 +05:30
sos_installation_commision Fix for Issue #2 2025-07-24 18:23:58 +05:30
sos_inventory Reference #9 2025-08-11 16:26:29 +05:30
sos_marketing Reference for #6 2025-08-06 10:49:58 +05:30
sos_sales Reference #7 2025-08-11 11:14:47 +05:30
README.md Update README.md 2025-07-23 18:34:57 +05:30

README.md

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:

    sudo apt update && sudo apt upgrade -y
    
  2. Install Dependencies
    Install required system packages, Python, and PostgreSQL:

    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:

    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:

    sudo apt install -y postgresql
    sudo systemctl start postgresql
    sudo systemctl enable postgresql
    

    Create a PostgreSQL user for Odoo:

    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:

    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:

    python3 -m venv ~/odoo/venv
    source ~/odoo/venv/bin/activate
    
  7. Install Python Dependencies
    Install Odoos Python dependencies:

    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:

    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):

    nano ~/odoo/odoo.conf
    

    Add the following content, adjusting paths and credentials as needed:

    [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:

    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 Odoos 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
  • If you encounter issues, consult the Odoo community forums or contact the module developers.