Cài đặt nguồn¶
The source 'installation' is not about installing Odoo but running it directly from the source instead.
Using the Odoo source can be more convenient for module developers as it is more easily accessible than using packaged installers.
It makes starting and stopping Odoo more flexible and explicit than the services set up by the packaged installers. Also, it allows overriding settings using command-line parameters without needing to edit a configuration file.
Finally, it provides greater control over the system's setup and allows to more easily keep (and run) multiple versions of Odoo side-by-side.
Fetch the sources¶
There are two ways to obtain the source code of Odoo: as a ZIP archive or through Git.
Lưu trữ¶
Phiên bản Community:
Phiên bản Enterprise:
Git¶
Ghi chú
It is required to have Git installed, and it is recommended to have a basic knowledge of Git commands to proceed.
To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code or when following the Getting Started developer tutorial.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone [email protected]:odoo/odoo.git
$ git clone [email protected]:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone [email protected]:odoo/odoo.git
C:\> git clone [email protected]:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone [email protected]:odoo/odoo.git
$ git clone [email protected]: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 requires Python 3.10 or later to run.
Thay đổi trong phiên bản 17: Minimum requirement updated from Python 3.7 to Python 3.10.
Use a package manager to download and install Python 3 if needed.
Download the latest version of Python 3 and install it.
During installation, check Add Python 3 to PATH, then click Customize Installation and make sure that pip is checked.
Ghi chú
If Python 3 is already installed, make sure that the version is 3.10 or above, as previous versions are not compatible with Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verify that pip is also installed for this version.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo uses PostgreSQL as its database management system.
Use a package manager to download and install PostgreSQL (supported versions: 12.0 or above). It can be achieved by executing the following:
$ sudo apt install postgresql postgresql-client
Download PostgreSQL (supported versions: 12.0 or above) and install it.
Use Postgres.app to download and install PostgreSQL (supported version: 12.0 or above).
Mẹo
To make the command line tools bundled with Postgres.app available, make sure to set up the
$PATH variable by following the Postgres.app CLI tools instructions.
By default, the only user is postgres. As Odoo forbids connecting as postgres, create a new
PostgreSQL user.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Ghi chú
Because the PostgreSQL user has the same name as the Unix login, it is possible to connect to the database without a password.
Add PostgreSQL's
bindirectory (by default:C:\Program Files\PostgreSQL\<version>\bin) to thePATH.Create a postgres user with a password using the pg admin gui:
Mở pgAdmin.
Double-click the server to create a connection.
Select .
Enter the username in the Role Name field (e.g.,
odoo).Open the Definition tab, enter a password (e.g.,
odoo), and click Save.Open the Privileges tab and switch Can login? to
Yesand Create database? toYes.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Ghi chú
Because the PostgreSQL user has the same name as the Unix login, it is possible to connect to the database without a password.
Phần phụ thuộc¶
Using distribution packages is the preferred way of installing dependencies. Alternatively, install the Python dependencies with pip.
On Debian/Ubuntu, the following commands should install the required packages:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh script will parse the debian/control file and install the found packages.
Cảnh báo
Using pip may lead to security issues and broken dependencies; only do this if you know what you are doing.
As some of the Python packages need a compilation step, they require system libraries to be installed.
On Debian/Ubuntu, the following command should install these required libraries:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo dependencies are listed in the requirements.txt file located at the root of
the Odoo Community directory.
Ghi chú
The Python packages in requirements.txt are based on their stable/LTS
Debian/Ubuntu corresponding version at the moment of the Odoo release. For example,
for Odoo 15.0, the python3-babel package version is 2.8.0 in Debian Bullseye and
2.6.0 in Ubuntu Focal. The lowest version is then chosen in the
requirements.txt.
Mẹo
It can be preferable not to mix Python module packages between different instances of Odoo or with the system. However, it is possible to use virtualenv to create isolated Python environments.
Navigate to the path of the Odoo Community installation (CommunityPath) and run
pip on the requirements file to install the requirements for the current user.
$ cd /CommunityPath
$ pip install -r requirements.txt
Before installing the dependencies, download and install the Build Tools for Visual Studio. Select C++ build tools in the Workloads tab and install them when prompted.
Odoo dependencies are listed in the requirements.txt file located at the root of the Odoo
Community directory.
Mẹo
It can be preferable not to mix Python module packages between different instances of Odoo or with the system. However, it is possible to use virtualenv to create isolated Python environments.
Navigate to the path of the Odoo Community installation (CommunityPath) and run pip on
the requirements file in a terminal with Administrator privileges:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo dependencies are listed in the requirements.txt file located at the root of the Odoo
Community directory.
Mẹo
It can be preferable not to mix Python module packages between different instances of Odoo or with the system. However, it is possible to use virtualenv to create isolated Python environments.
Navigate to the path of the Odoo Community installation (CommunityPath) and run pip on
the requirements file:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Ghi chú
For languages using a right-to-left interface (such as Arabic or Hebrew), the rtlcss
package is required.
Download and install nodejs and npm with a package manager.
Cài đặt
rtlcss:$ sudo npm install -g rtlcss
Tải xuống và cài đặt nodejs.
Cài đặt
rtlcss:C:\> npm install -g rtlcssEdit the system environment's variable
PATHto add the folder wherertlcss.cmdis located (typically:C:\Users\<user>\AppData\Roaming\npm\).
Cảnh báo
wkhtmltopdf is not installed through pip and must be installed manually in version 0.12.6 for it to support headers
and footers. Check out the wkhtmltopdf wiki
for more details on the various versions.
Chạy Odoo¶
Once all dependencies are set up, Odoo can be launched by running odoo-bin, the command-line
interface of the server. It is located at the root of the Odoo Community directory.
To configure the server, either specify command-line arguments or a configuration file.
Mẹo
For the Enterprise edition, add the path to the enterprise add-ons to the addons-path
argument. Note that it must come before the other paths in addons-path for add-ons to be loaded
correctly.
Cấu hình cần thiết phổ biến là:
Người dùng và mật khẩu PostgreSQL.
Custom addon paths beyond the defaults to load custom modules.
A typical way to run the server would be:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Where CommunityPath is the path of the Odoo Community installation, and mydb is the name
of the PostgreSQL database.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Where CommunityPath is the path of the Odoo Community installation, dbuser is the
PostgreSQL login, dbpassword is the PostgreSQL password, and mydb is the name of the
PostgreSQL database.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Where CommunityPath is the path of the Odoo Community installation, and mydb is the name
of the PostgreSQL database.
After the server has started (the INFO log odoo.modules.loading: Modules loaded. is printed), open
http://localhost:8069 in a web browser and log into the Odoo database with the base administrator
account: use admin as the email and, again, admin as the password.
Mẹo