सोर्स इंस्टॉल¶

सोर्स 'इंस्टॉलेशन' Odoo इंस्टॉल करने के बारे में नहीं है, बल्कि इसे सीधे सोर्स से चलाने के बारे में है।

Odoo सोर्स का उपयोग मॉड्यूल डेवलपर्स के लिए ज़्यादा सुविधाजनक हो सकता है क्योंकि यह पैकेज्ड इंस्टॉलर्स का उपयोग करने की तुलना में ज़्यादा आसानी से एक्सेस किया जा सकता है।

यह Odoo को शुरू करने और बंद करने को पैकेज्ड इंस्टॉलर्स द्वारा सेट की गई सर्विस की तुलना में ज़्यादा लचीला और स्पष्ट बनाता है। साथ ही, यह कॉन्फ़िगरेशन फ़ाइल को बदलाव करने की ज़रूरत के बिना कमांड-लाइन पैरामीटर का उपयोग करके सेटिंग ओवरराइड करने की सुविधा देता है।

अंत में, यह सिस्टम के सेटअप पर ज़्यादा कंट्रोल देता है और Odoo के कई वर्ज़न को साथ-साथ रखने (और चलाने) की सुविधा देता है।

सोर्स प्राप्त करें¶

Odoo का सोर्स कोड प्राप्त करने के दो तरीके हैं: ZIP आर्काइव के रूप में या Git के माध्यम से।

संग्रहित करें¶

कम्युनिटी एडिशन:

एंटरप्राइज़ एडिशन:

Git¶

टिप्पणी

Git इंस्टॉल होना ज़रूरी है, और आगे बढ़ने के लिए Git कमांड की बेसिक जानकारी होना रेकमेंडेड है।

Git रिपॉज़िटरी क्लोन करने के लिए, HTTPS या SSH से क्लोन करने में से चुनें। ज़्यादातर मामलों में, HTTPS सबसे अच्छा विकल्प है। हालांकि, Odoo सोर्स कोड में योगदान देने के लिए या Getting Started डेवलपर ट्यूटोरियल फ़ॉलो करते समय SSH चुनें।

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

टिप्पणी

एंटरप्राइज़ git रिपॉज़िटरी में पूरा Odoo सोर्स कोड नहीं है। यह सिर्फ़ अतिरिक्त ऐड-ऑन का कलेक्शन है। मुख्य सर्वर कोड कम्युनिटी एडिशन में है। एंटरप्राइज़ वर्शन चलाने का मतलब है कम्युनिटी वर्शन से सर्वर को addons-path ऑप्शन के साथ चलाना जो एंटरप्राइज़ एडिशन के फ़ोल्डर पर सेट हो। काम करने वाले Odoo एंटरप्राइज़ इंस्टॉलेशन के लिए कम्युनिटी और एंटरप्राइज़ दोनों रिपॉज़िटरी को क्लोन करना ज़रूरी है।

तैयारी करें¶

Python¶

Odoo को चलाने के लिए Python 3.10 या उसके बाद के वर्शन की ज़रूरत है।

संस्करण 17 से अलग : न्यूनतम आवश्यकता Python 3.7 से Python 3.10 में अपडेट की गई।

अगर ज़रूरत हो तो Python 3 को डाउनलोड और इंस्टॉल करने के लिए पैकेज मैनेजर का इस्तेमाल करें।

टिप्पणी

अगर Python 3 पहले से इंस्टॉल है, तो सुनिश्चित करें कि वर्शन 3.10 या उससे ऊपर हो, क्योंकि पिछले वर्शन Odoo के साथ कम्पैटिबल नहीं हैं।

$ python3 --version

C:\> python --version

$ python3 --version

इस वर्शन के लिए pip भी इंस्टॉल है, इसकी पुष्टि करें।

$ pip3 --version

C:\> pip --version

$ pip3 --version

PostgreSQL¶

Odoo अपने डेटाबेस मैनेजमेंट सिस्टम के रूप में PostgreSQL का इस्तेमाल करता है।

संस्करण 19 से अलग : न्यूनतम आवश्यकता PostgreSQL 12 से PostgreSQL 13 में अपडेट की गई।

PostgreSQL को डाउनलोड और इंस्टॉल करने के लिए पैकेज मैनेजर का इस्तेमाल करें (सपोर्टेड वर्शन: 13.0 या उसके बाद)। यह निम्नलिखित को एक्ज़ीक्यूट करके हासिल किया जा सकता है:

$ sudo apt install postgresql postgresql-client

PostgreSQL को डाउनलोड और इंस्टॉल करने के लिए Postgres.app का इस्तेमाल करें (सपोर्टेड वर्शन: 13.0 या उसके बाद)।

सलाह

Postgres.app के साथ बंडल किए गए कमांड लाइन टूल्स को उपलब्ध कराने के लिए, Postgres.app CLI tools instructions को फ़ॉलो करके $PATH वेरिएबल सेट अप करना सुनिश्चित करें।

डिफ़ॉल्ट रूप से, सिर्फ़ एक उपयोगकर्ता postgres होता है। क्योंकि Odoo postgres के रूप में कनेक्ट करने से मना करता है, एक नया PostgreSQL उपयोगकर्ता बनाएं।

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

टिप्पणी

चूंकि PostgreSQL उपयोगकर्ता का नाम Unix लॉगिन के समान है, इसलिए पासवर्ड के बिना डेटाबेस से कनेक्ट करना संभव है।

PostgreSQL की bin डायरेक्टरी (डिफ़ॉल्ट रूप से: C:\Program Files\PostgreSQL\<version>\bin) को PATH में जोड़ें।
pg admin GUI का इस्तेमाल करके पासवर्ड के साथ postgres यूज़र बनाएं:
1. pgAdmin खोलें।
2. कनेक्शन बनाने के लिए सर्वर पर डबल-क्लिक करें।
3. Object ‣ Create ‣ Login/Group Role सेलेक्ट करें।
4. Role Name फ़ील्ड में यूज़रनेम दर्ज करें (जैसे odoo)।
5. Definition टैब खोलें, पासवर्ड दर्ज करें (जैसे odoo), और Save पर क्लिक करें।
6. Privileges टैब खोलें और Can login? को Yes और Create database? को Yes में बदलें।

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

टिप्पणी

अगर आप Odoo की एआई सुविधाओं का इस्तेमाल करना चाहते हैं, तो pg-vector PostgreSQL एक्सटेंशन ज़रूरी है।

ध्यान दें कि pg-vector सिर्फ़ PostgreSQL वर्शन 15 और उससे ऊपर के लिए उपलब्ध है।

अपने टेम्पररी फ़ोल्डर पर जाएँ
```
$ cd /tmp
```
pg-vector GitHub repository को क्लोन करें:
```
$ git clone https://github.com/pgvector/pgvector.git
```
डायरेक्टरी में जाएँ:
```
$ cd pgvector
```
एक्सटेंशन को कंपाइल करें:
```
$ make
```
एक्सटेंशन को इंस्टॉल करें:
```
$ sudo make install
```

अगर इंस्टॉलेशन के दौरान कोई समस्या आती है, तो आधिकारिक installation notes ज़रूर देखें।

अपने टेम्पररी फ़ोल्डर पर जाएँ
```
$ cd /tmp
```
pg-vector GitHub repository को क्लोन करें:
```
$ git clone https://github.com/pgvector/pgvector.git
```
डायरेक्टरी में जाएँ:
```
$ cd pgvector
```
एक्सटेंशन को कंपाइल करें:
```
$ make
```
एक्सटेंशन को इंस्टॉल करें:
```
$ sudo make install
```

अगर इंस्टॉलेशन के दौरान कोई समस्या आती है, तो आधिकारिक installation notes ज़रूर देखें।

अपने टेम्पररी फ़ोल्डर पर जाएँ
```
$ cd %TEMP%
```
pg-vector GitHub repository को क्लोन करें:
```
$ git clone https://github.com/pgvector/pgvector.git
```
डायरेक्टरी में जाएँ:
```
$ cd pgvector
```
सुनिश्चित करें कि Visual Studio में C++ सपोर्ट इंस्टॉल है और x64 Native Tools Command Prompt for VS [version] को एडमिन के रूप में चलाएँ।
अपना PGROOT एन्वायरमेंट वेरिएबल सेट करें:
```
$ set "PGROOT=C:\Program Files\PostgreSQL\[Your PostgreSQL Version]"
```
एक्सटेंशन को कंपाइल करें:
```
$ nmake /F Makefile.win
```
एक्सटेंशन को इंस्टॉल करें:
```
$ nmake /F Makefile.win install
```

अगर इंस्टॉलेशन के दौरान आपको कोई समस्या आती है, तो आधिकारिक इंस्टॉलेशन नोट्स की जांच अवश्य करें।

निर्भरता¶

distribution packages का इस्तेमाल डिपेंडेंसीज़ इंस्टॉल करने का पसंदीदा तरीका है। वैकल्पिक रूप से, Python डिपेंडेंसीज़ को pip से इंस्टॉल करें।

Debian/Ubuntu पर, निम्नलिखित कमांड्स ज़रूरी पैकेजेज़ इंस्टॉल करने चाहिए:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

setup/debinstall.sh स्क्रिप्ट debian/control फ़ाइल को पार्स करेगी और मिले हुए पैकेजेज़ को इंस्टॉल करेगी।

चेतावनी

pip का इस्तेमाल करने से सुरक्षा समस्याएं और टूटी हुई डिपेंडेंसीज़ हो सकती हैं; सिर्फ़ तभी करें जब आप जानते हों कि आप क्या कर रहे हैं।

चूंकि कुछ Python पैकेजेज़ को कंपाइलेशन स्टेप की ज़रूरत होती है, इसलिए उन्हें सिस्टम लाइब्रेरीज़ इंस्टॉल करने की ज़रूरत होती है।

Debian/Ubuntu पर, निम्नलिखित कमांड इन ज़रूरी लाइब्रेरीज़ को इंस्टॉल करनी चाहिए:

$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

Odoo डिपेंडेंसीज़ requirements.txt फ़ाइल में लिस्ट की गई हैं जो Odoo Community डायरेक्टरी के रूट पर स्थित है।

टिप्पणी

requirements.txt में Python पैकेजेज़ Odoo रिलीज़ के समय उनके stable/LTS Debian/Ubuntu संबंधित वर्शन पर आधारित हैं। उदाहरण के लिए, Odoo 15.0 के लिए, python3-babel पैकेज वर्शन Debian Bullseye में 2.8.0 और Ubuntu Focal में 2.6.0 है। फिर requirements.txt में सबसे कम वर्शन चुना जाता है।

सलाह

Odoo के अलग-अलग इंस्टेंसेज़ के बीच या सिस्टम के साथ Python मॉड्यूल पैकेजेज़ को मिक्स न करना बेहतर हो सकता है। हालांकि, आइसोलेटेड Python एनवायरनमेंट बनाने के लिए virtualenv का इस्तेमाल करना संभव है।

Odoo Community इंस्टॉलेशन के पाथ (CommunityPath) पर नेविगेट करें और मौजूदा यूज़र के लिए requirements इंस्टॉल करने के लिए requirements फ़ाइल पर pip रन करें।

$ cd /CommunityPath
$ pip install -r requirements.txt

डिपेंडेंसीज़ इंस्टॉल करने से पहले, Build Tools for Visual Studio डाउनलोड और इंस्टॉल करें। Workloads टैब में C++ build tools सेलेक्ट करें और प्रॉम्प्ट होने पर उन्हें इंस्टॉल करें।

Odoo डिपेंडेंसी requirements.txt फ़ाइल में सूचीबद्ध हैं जो Odoo कम्युनिटी डायरेक्टरी के रूट में स्थित है।

सलाह
Odoo के अलग-अलग इंस्टेंसेज़ के बीच या सिस्टम के साथ Python मॉड्यूल पैकेजेज़ को मिक्स न करना बेहतर हो सकता है। हालांकि, आइसोलेटेड Python एनवायरनमेंट बनाने के लिए virtualenv का इस्तेमाल करना संभव है।

Odoo कम्युनिटी इंस्टॉलेशन के पाथ (CommunityPath) पर जाएं और टर्मिनल में एडमिन प्रिविलेज के साथ requirements फ़ाइल पर pip चलाएं:

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

सलाह
Odoo के अलग-अलग इंस्टेंसेज़ के बीच या सिस्टम के साथ Python मॉड्यूल पैकेजेज़ को मिक्स न करना बेहतर हो सकता है। हालांकि, आइसोलेटेड Python एनवायरनमेंट बनाने के लिए virtualenv का इस्तेमाल करना संभव है।

Odoo कम्युनिटी इंस्टॉलेशन के पाथ (CommunityPath) पर जाएं और requirements फ़ाइल पर pip चलाएं:

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

चेतावनी

नॉन-Python डिपेंडेंसी को पैकेज मैनेजर (Homebrew, MacPorts) से इंस्टॉल करना होगा।

Command Line Tools डाउनलोड और इंस्टॉल करें:
```
$ xcode-select --install
```
नॉन-Python डिपेंडेंसी इंस्टॉल करने के लिए पैकेज मैनेजर इस्तेमाल करें।

टिप्पणी

राइट-टू-लेफ्ट इंटरफ़ेस इस्तेमाल करने वाली भाषाओं (जैसे अरबी या हिब्रू) के लिए, rtlcss पैकेज आवश्यक है।

पैकेज मैनेजर से nodejs और npm डाउनलोड और इंस्टॉल करें।
rtlcss इंस्टॉल करें:
```
$ sudo npm install -g rtlcss
```

nodejs डाउनलोड और इंस्टॉल करें।
rtlcss इंस्टॉल करें:
```
C:\> npm install -g rtlcss
```
सिस्टम एनवायरमेंट के वेरिएबल PATH को बदलाव करें और वह फ़ोल्डर जोड़ें जहां rtlcss.cmd स्थित है (आमतौर पर: C:\Users\<user>\AppData\Roaming\npm\)।

पैकेज मैनेजर (Homebrew, MacPorts) से nodejs डाउनलोड और इंस्टॉल करें।
rtlcss इंस्टॉल करें:
```
$ sudo npm install -g rtlcss
```

चेतावनी

wkhtmltopdf को pip के ज़रिए इंस्टॉल नहीं किया जाता और इसे वर्शन 0.12.6 में मैन्युअली इंस्टॉल करना होगा ताकि यह हेडर और फ़ुटर को सपोर्ट कर सके। विभिन्न वर्शन्स के बारे में ज़्यादा जानकारी के लिए wkhtmltopdf wiki देखें।

Odoo चलाना¶

सभी डिपेंडेंसी सेट अप हो जाने के बाद, odoo-bin चलाकर Odoo लॉन्च किया जा सकता है, जो सर्वर का कमांड-लाइन इंटरफ़ेस है। यह Odoo कम्युनिटी डायरेक्टरी के रूट में स्थित है।

सर्वर को कॉन्फ़िगर करने के लिए, या तो कमांड-लाइन आर्ग्युमेंट या कॉन्फ़िगरेशन फ़ाइल निर्दिष्ट करें।

सलाह

एंटरप्राइज एडिशन के लिए, enterprise ऐड-ऑन का पाथ addons-path आर्ग्युमेंट में जोड़ें। ध्यान दें कि ऐड-ऑन सही तरीके से लोड होने के लिए यह addons-path में अन्य पाथ से पहले आना चाहिए।

सामान्य आवश्यक कॉन्फ़िगरेशन हैं:

PostgreSQL उपयोगकर्ता और पासवर्ड।
कस्टम मॉड्यूल लोड करने के लिए डिफ़ॉल्ट से परे कस्टम ऐडऑन पाथ।

सर्वर चलाने का एक सामान्य तरीका यह होगा:

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

जहां CommunityPath Odoo कम्युनिटी इंस्टॉलेशन का पाथ है, और mydb PostgreSQL डेटाबेस का नाम है।

C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb

जहां CommunityPath Odoo कम्युनिटी इंस्टॉलेशन का पाथ है, dbuser PostgreSQL लॉगिन है, dbpassword PostgreSQL पासवर्ड है, और mydb PostgreSQL डेटाबेस का नाम है।

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

जहां CommunityPath Odoo कम्युनिटी इंस्टॉलेशन का पाथ है, और mydb PostgreSQL डेटाबेस का नाम है।

सर्वर शुरू होने के बाद (INFO लॉग odoo.modules.loading: Modules loaded. प्रिंट हो जाता है), वेब ब्राउज़र में http://localhost:8069 खोलें और बेस एडमिन अकाउंट से Odoo डेटाबेस में लॉगिन करें: ईमेल के रूप में admin इस्तेमाल करें और फिर से, पासवर्ड के रूप में admin इस्तेमाल करें।

सलाह

वहां से, नए उपयोगकर्ता बनाएं और मैनेज करें।
Odoo के वेब इंटरफ़ेस में लॉगिन करने के लिए इस्तेमाल किया गया उपयोगकर्ता अकाउंट --db_user CLI आर्ग्युमेंट से अलग है।

यह भी देखें

odoo-bin के लिए CLI आर्ग्युमेंट्स की लिस्ट