Cài đặt nguồn

'Cài đặt' nguồn không phải là cài đặt Odoo mà là chạy Odoo trực tiếp từ nguồn.

Việc sử dụng nguồn Odoo có thể thuận tiện hơn cho các lập trình viên phân hệ vì nó dễ truy cập hơn so với việc sử dụng trình cài đặt trọn gói.

Việc khởi động và dừng Odoo trở nên linh hoạt và rõ ràng hơn so với các dịch vụ được thiết lập bởi trình cài đặt trọn gói. Ngoài ra, nó cho phép ghi đè cài đặt bằng cách sử dụng tham số dòng lệnh mà không cần chỉnh sửa tệp cấu hình.

Cuối cùng là nó nâng cao khả năng kiểm soát đối với thiết lập hệ thống và cho phép dễ dàng duy trì (và chạy) nhiều phiên bản Odoo song song.

Lấy nguồn

Có hai cách để lấy mã nguồn của Odoo: dưới dạng lưu trữ ZIP hoặc thông qua Git.

Lưu trữ

Phiên bản Community:

Phiên bản Enterprise:

Git

Ghi chú

Bạn cần phải cài đặt Git và nên có kiến thức cơ bản về các lệnh Git để có thể tiếp tục.

Để sao chép kho lưu trữ Git, hãy chọn một trong hai cách sao chép bằng HTTPS hoặc SSH. Trong hầu hết trường hợp, tùy chọn tốt nhất là HTTPS. Tuy nhiên, hãy chọn SSH nếu bạn muốn đóng góp vào mã nguồn Odoo hoặc khi làm theo Hướng dẫn bắt đầu dành cho lập trình viên.

$ 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

Ghi chú

Kho lưu trữ git Enterprise không chứa mã nguồn Odoo đầy đủ. Nó chỉ là một tập hợp các add-on bổ sung. Mã máy chủ chính nằm trong phiên bản Community. Chạy phiên bản Enterprise có nghĩa là chạy máy chủ từ phiên bản Community với tùy chọn addons-path được thiết lập cho phiên bản Enterprise trong một thư mục cụ thể. Cần phải sao chép cả kho lưu trữ Community và Enterprise để bản cài đặt Odoo Enterprise hoạt động.

Chuẩn bị

Python

Odoo yêu cầu Python 3.10 trở lên để có thể hoạt động.

Thay đổi trong phiên bản 17: Yêu cầu tối thiểu được cập nhật từ Python 3.7 lên Python 3.10.

Sử dụng trình quản lý gói để tải xuống và cài đặt Python 3 nếu cần.

Ghi chú

Nếu Python 3 đã được cài đặt, hãy đảm bảo đó là phiên bản 3.10 trở lên vì các phiên bản trước đó không tương thích với Odoo.

$ python3 --version

Hãy xác nhận pip cũng được cài đặt cho phiên bản này.

$ pip3 --version

PostgreSQL

Odoo sử dụng PostgreSQL làm hệ thống quản lý cơ sở dữ liệu.

Thay đổi trong phiên bản 19: Yêu cầu tối thiểu được cập nhật từ PostgreSQL 12 lên PostgreSQL 13.

Sử dụng trình quản lý gói để tải xuống và cài đặt PostgreSQL (các phiên bản được hỗ trợ: 13.0 trở lên). Điều này có thể thực hiện bằng cách chạy lệnh sau:

$ sudo apt install postgresql postgresql-client

Theo mặc định, người dùng duy nhất là postgres. Vì Odoo cấm kết nối dưới dạng postgres, hãy tạo một người dùng PostgreSQL mới.

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

Ghi chú

Vì người dùng PostgreSQL có cùng tên với tên đăng nhập Unix nên có thể kết nối với cơ sở dữ liệu mà không cần mật khẩu.

Ghi chú

Nếu bạn muốn sử dụng các tính năng AI của Odoo, cần có tiện ích mở rộng pg-vector của PostgreSQL.

Lưu ý rằng pg-vector chỉ khả dụng cho PostgreSQL phiên bản 15 trở lên.

  1. Điều hướng đến thư mục tạm thời của bạn

    $ cd /tmp

  2. Sao chép kho GitHub pg-vector:

    $ git clone https://github.com/pgvector/pgvector.git

  3. Điều hướng vào thư mục:

    $ cd pgvector

  4. Biên dịch tiện ích mở rộng:

    $ make

  5. Cài đặt tiện ích mở rộng:

    $ sudo make install

Nếu bạn gặp bất kỳ vấn đề nào trong quá trình cài đặt, hãy đảm bảo kiểm tra ghi chú cài đặt chính thức.

Phụ thuộc

Việc sử dụng gói phân phối là cách cài đặt phụ thuộc được ưu tiên. Ngoài ra, hãy cài đặt các phụ thuộc Python bằng pip.

Trên Debian/Ubuntu, các lệnh sau sẽ cài đặt các gói cần thiết:

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

Tệp lệnh setup/debinstall.sh sẽ phân tích tệp debian/control <https://github.com/odoo/odoo/blob/19.0/debian/control> và cài đặt các gói tìm thấy.

Ghi chú

Đối với các ngôn ngữ sử dụng giao diện từ phải sang trái (như tiếng Ả Rập hoặc tiếng Do Thái), gói rtlcss là điều kiện bắt buộc.

  1. Tải xuống và cài đặt nodejs và npm bằng trình quản lý gói.

  2. Cài đặt rtlcss:

    $ sudo npm install -g rtlcss

Cảnh báo

wkhtmltopdf không được cài đặt thông qua pip và phải được cài đặt thủ công trong phiên bản 0.12.6 để hỗ trợ header và footer. Tham khảo wiki wkhtmltopdf để biết thêm chi tiết về các phiên bản khác nhau.

Chạy Odoo

Sau khi tất cả phụ thuộc được thiết lập, bạn có thể khởi chạy Odoo bằng cách chạy odoo-bin, giao diện dòng lệnh của máy chủ. Giao diện này nằm ở gốc của thư mục Odoo Community.

Để cấu hình máy chủ, hãy chỉ định đối số dòng lệnh hoặc tệp cấu hình.

Mẹo

Đối với phiên bản Enterprise, thêm đường dẫn đến add-on enterprise vào đối số addons-path. Lưu ý rằng nó phải đứng trước các đường dẫn khác trong addons-path để add-on được tải chính xác.

Cấu hình cần thiết phổ biến là:

  • Người dùng và mật khẩu PostgreSQL.

  • Đường dẫn add-on tùy chỉnh ngoài đường dẫn mặc định để tải các phân hệ tùy chỉnh.

Một cách điển hình để chạy máy chủ là:

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

Trong đó CommunityPath là đường dẫn cài đặt Odoo Community và mydb là tên cơ sở dữ liệu PostgreSQL.

Sau khi máy chủ khởi động (nhật ký INFO odoo.modules.loading: Modules loaded. được in), hãy mở http://localhost:8069 trong trình duyệt web và đăng nhập vào cơ sở dữ liệu Odoo bằng tài khoản quản trị viên cơ sở: sử dụng admin làm email và admin làm mật khẩu.

Mẹo

  • Từ đó, tạo và quản lý users mới.

  • Tài khoản người dùng được sử dụng để đăng nhập vào giao diện web của Odoo khác với đối số CLI --db_user.

Xem thêm

Danh sách các đối số CLI cho odoo-bin