1️⃣ پیش‌نیازها

پیش از نصب Odoo، ابتدا سیستم خود را به‌روزرسانی کرده و PostgreSQL را نصب کنید. اودو از PostgreSQL به عنوان پایگاه داده استفاده می‌کند.

sudo apt update
sudo apt upgrade -y

sudo apt install postgresql -y

در صورت نیاز به توسعه ماژول‌های اختصاصی یا نصب Odoo از سورس، پیشنهاد می‌شود ابزارهای توسعه زیر را نیز نصب کنید:

sudo apt install -y \
git \
curl \
wget \
build-essential \
python3-dev \
python3-pip \
python3-venv \
python3-wheel \
libxml2-dev \
libxslt1-dev \
libldap2-dev \
libsasl2-dev \
libjpeg-dev \
zlib1g-dev \
libpq-dev \
libffi-dev \
libssl-dev \
libtiff-dev \
libopenjp2-7-dev \
liblcms2-dev \
libwebp-dev \
libharfbuzz-dev \
libfribidi-dev \
libxcb1-dev \
xfonts-75dpi \
xfonts-base \
fontconfig

نکته: در نصب از طریق فایل .deb معمولاً نیازی به نصب تمامی کتابخانه‌های توسعه نیست، اما وجود آن‌ها برای توسعه ماژول‌های سفارشی یا نصب از سورس مفید خواهد بود.

💡 نکته:

نسخه Odoo 18 به صورت رسمی روی Ubuntu 22.04 و Debian 12 یا نسخه‌های جدیدتر پشتیبانی می‌شود.

2️⃣ دریافت فایل‌های نصب Odoo

در این مرحله بسته به نسخه‌ای که قصد استفاده از آن را دارید، دو مسیر متفاوت وجود دارد.

الف) نسخه Community

اگر قصد استفاده از نسخه رایگان Community را دارید، می‌توانید سورس آن را از مخزن رسمی GitHub دریافت کنید:

git clone https://github.com/odoo/odoo --depth 1 --branch 19.0

همچنین در صورت تمایل می‌توانید بسته‌های آماده نصب (Package Installer) را از وب‌سایت رسمی Odoo دانلود و نصب کنید.

ب) نسخه Enterprise

اگر از نسخه Enterprise استفاده می‌کنید، باید فایل نصب (.deb) یا سورس مربوط به نسخه تجاری را از حساب کاربری خود در Odoo دریافت کرده و به سرور لینوکسی منتقل کنید.

در این آموزش فرض می‌کنیم فایل نصب با نام زیر در سرور قرار گرفته است:

odoo_19e.deb

در صورتی که فایل .deb را در اختیار دارید، نیازی به دریافت سورس Community از GitHub نخواهید داشت و می‌توانید مستقیماً آن را نصب کنید.

3️⃣ نصب Odoo

نصب از طریق فایل .deb (مناسب برای Enterprise)

پس از انتقال فایل نصب به سرور، دستورات زیر را اجرا کنید:

sudo apt install ./odoo_19e.deb

دستور apt-get install -f وابستگی‌های موردنیاز را نصب کرده و در صورت وجود خطاهای مربوط به بسته‌ها، آن‌ها را برطرف می‌کند.

نصب از سورس (مناسب برای Community)

اگر نسخه Community را از Git دریافت کرده‌اید، وارد پوشه پروژه شوید و وابستگی‌های پایتون را نصب کنید:

cd odoo

pip install --upgrade pip
pip install wheel
pip install -r requirements.txt

⚠️ توجه: فایل requirements.txt فقط در نصب از روی سورس وجود دارد. اگر از فایل .deb استفاده می‌کنید، نیازی به اجرای این دستور نیست.

4️⃣ تنظیم اتصال به PostgreSQL

پس از نصب، فایل تنظیمات Odoo معمولاً در مسیر زیر قرار دارد:

/etc/odoo/odoo.conf

در این فایل، اطلاعات اتصال به پایگاه داده قابل مشاهده است:

db_host = False
db_port = False
db_user = odoo
db_password = YourPassword

در صورتی که کاربر PostgreSQL به صورت خودکار ایجاد نشده باشد، می‌توانید آن را به صورت دستی ایجاد کنید:

CREATE USER odoo WITH PASSWORD 'YourPassword';
ALTER USER odoo CREATEDB;

همچنین در همین فایل می‌توانید تنظیماتی مانند addons_path و admin_passwd را نیز مدیریت کنید.

5️⃣ نصب پیش‌نیازهای تکمیلی

برای جلوگیری از بروز خطا در برخی ماژول‌ها یا خروجی‌های Excel، نصب کتابخانه‌های زیر توصیه می‌شود:

pip3 install xlwt
pip3 install num2words

نصب و پیکربندی wkhtmltopdf

برای تولید صحیح گزارش‌های PDF (به‌ویژه گزارش‌هایی که دارای هدر و فوتر هستند)، نصب wkhtmltopdf ضروری است.

sudo apt install wkhtmltopdf -y

💡 توصیه می‌شود از نسخه 0.12.6 استفاده کنید، زیرا برخی نسخه‌های دیگر ممکن است باعث به‌هم‌ریختگی قالب گزارش‌های PDF شوند.

6️⃣ اجرای سرویس Odoo

پس از اتمام نصب، سرویس Odoo معمولاً به صورت خودکار اجرا می‌شود.

برای بررسی وضعیت سرویس:

sudo systemctl status odoo

برای اجرای مجدد یا توقف سرویس:

sudo systemctl start odoo

sudo systemctl stop odoo

sudo systemctl restart odoo

7️⃣ ورود به محیط Odoo

پس از اجرای موفق سرویس، مرورگر خود را باز کرده و آدرس زیر را وارد کنید:

http://localhost:8069

اگر Odoo را روی یک سرور راه دور نصب کرده‌اید، به جای localhost از IP یا دامنه سرور استفاده کنید:

http://<server-ip>:8069

اکنون می‌توانید پایگاه داده جدید ایجاد کرده و وارد محیط Odoo شوید. 🎉

8️⃣ خطاهای رایج

خطای PermissionError

اگر با خطایی مشابه زیر مواجه شدید:

PermissionError: [Errno 13] Permission denied: '/opt/odoo/.local'

به این معناست که کاربر odoo اجازه نوشتن در پوشه Home خود را ندارد.

این مشکل معمولاً با اصلاح مالکیت پوشه برطرف می‌شود:

sudo chown -R odoo:odoo /opt/odoo

سپس سرویس Odoo را مجدداً راه‌اندازی کنید:

sudo systemctl restart odoo

💡 نکات پایانی و توصیه‌ها

• قبل از ارتقاء نسخه یا اعمال تغییرات مهم، حتماً از پایگاه داده خود نسخه پشتیبان (Backup) تهیه کنید.
• برای محیط‌های عملیاتی (Production)، استفاده از Ubuntu Server 22.04 یا Debian 12 توصیه می‌شود.
• در صورت استفاده از نسخه Enterprise با فایل .deb، نیازی به اجرای دستور pip install -r requirements.txt نیست.
• اگر از سورس Odoo استفاده می‌کنید، حتماً وابستگی‌های پروژه را از طریق فایل requirements.txt نصب کنید.
• برای جلوگیری از مشکلات مربوط به گزارش‌های PDF، از نسخه سازگار wkhtmltopdf استفاده کنید.
• در پروژه‌های بزرگ، استفاده از سرور مجزا برای PostgreSQL و راه‌اندازی Reverse Proxy مانند Nginx می‌تواند عملکرد و پایداری سیستم را بهبود دهد.
• در پروژه‌های بزرگ، استفاده از سرور مجزا برای PostgreSQL و انجام تنظیمات بهینه‌سازی می‌تواند عملکرد و پایداری سیستم را به میزان قابل توجهی افزایش دهد.