Instalacja ze źródeł¶
„Instalacja” ze źródeł nie polega na instalowaniu Odoo, ale na uruchamianiu go bezpośrednio ze źródeł.
Korzystanie ze źródeł Odoo może być wygodniejsze dla programistów modułów, ponieważ jest łatwiej dostępne niż korzystanie z instalatorów pakietów.
Umożliwia bardziej elastyczne i jawne uruchamianie i zatrzymywanie Odoo niż usługi skonfigurowane przez instalatory pakietów. Pozwala również zastępować ustawienia za pomocą parametrów wiersza poleceń bez konieczności edytowania pliku konfiguracyjnego.
Zapewnia większą kontrolę nad konfiguracją systemu i pozwala łatwiej utrzymywać (i uruchamiać) wiele wersji Odoo równolegle.
Pobierz źródła¶
Istnieją dwa sposoby uzyskania kodu źródłowego Odoo: jako archiwum ZIP lub przez Git.
Archiwizuj¶
Edycja Community:
Edycja Enterprise:
Git¶
Informacja
Wymagane jest zainstalowanie Git, a zalecana jest podstawowa znajomość poleceń Git.
Aby sklonować repozytorium Git, wybierz między klonowaniem przez HTTPS lub SSH. W większości przypadków najlepszą opcją jest HTTPS. Wybierz jednak SSH, aby współtworzyć kod źródłowy Odoo lub podczas realizacji samouczka Pierwsze kroki dla programistów.
$ git clone --branch 20.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 20.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 20.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 20.0 --single-branch git@github.com:odoo/enterprise.git
C:\> git clone --branch 20.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 20.0 --single-branch https://github.com/odoo/enterprise.git
C:\> git clone --branch 20.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 20.0 --single-branch git@github.com:odoo/enterprise.git
$ git clone --branch 20.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 20.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 20.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 20.0 --single-branch git@github.com:odoo/enterprise.git
Informacja
Repozytorium git Enterprise nie zawiera pełnego kodu źródłowego Odoo. Jest to tylko zbiór dodatkowych dodatków. Główny kod serwera znajduje się w wersji Community. Uruchomienie wersji Enterprise oznacza uruchomienie serwera z wersji Community z opcją addons-path ustawioną na folder z wersją Enterprise. Wymagane jest sklonowanie zarówno repozytorium Community, jak i Enterprise, aby mieć działającą instalację Odoo Enterprise.
Przygotowanie¶
Python¶
Odoo requires Python 3.12 or later to run.
Zmienione w wersji 17: Minimalny wymóg zaktualizowany z Pythona 3.7 do Pythona 3.10.
Zmienione w wersji 20: Minimum requirement updated from Python 3.10 to Python 3.12.
Użyj menedżera pakietów, aby pobrać i zainstalować Pythona 3, jeśli to konieczne.
Pobierz najnowszą wersję Pythona 3 i zainstaluj ją.
Podczas instalacji zaznacz Add Python 3 to PATH, następnie kliknij Customize Installation i upewnij się, że pip jest zaznaczony.
Informacja
Jeśli Python 3 jest już zainstalowany, upewnij się, że wersja to 3.10 lub wyższa, ponieważ poprzednie wersje nie są kompatybilne z Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Sprawdź, czy pip jest również zainstalowany dla tej wersji.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo używa PostgreSQL jako systemu zarządzania bazą danych.
Zmienione w wersji 19: Minimalne wymaganie zaktualizowano z PostgreSQL 12 do PostgreSQL 13.
Zmienione w wersji 20: Minimum requirement updated from PostgreSQL 13 to PostgreSQL 16.
Use a package manager to download and install PostgreSQL (supported versions: 16.0 or above). It can be achieved by executing the following:
$ sudo apt install postgresql postgresql-client
Download PostgreSQL (supported versions: 16.0 or above) and install it.
Use Postgres.app to download and install PostgreSQL (supported version: 16.0 or above).
Wskazówka
Aby udostępnić narzędzia wiersza poleceń dołączone do Postgres.app, upewnij się, że skonfigurowałeś zmienną $PATH, postępując zgodnie z instrukcjami narzędzi CLI Postgres.app.
Domyślnie jedynym użytkownikiem jest postgres. Ponieważ Odoo zabrania łączenia się jako postgres, utwórz nowego użytkownika PostgreSQL.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Informacja
Ponieważ użytkownik PostgreSQL ma taką samą nazwę jak login Unix, możliwe jest połączenie z bazą danych bez hasła.
Dodaj katalog
binPostgreSQL (domyślnie:C:\Program Files\PostgreSQL\<version>\bin) doPATH.Utwórz użytkownika postgres z hasłem, używając interfejsu graficznego pg admin:
Otwórz pgAdmin.
Kliknij dwukrotnie serwer, aby utworzyć połączenie.
Wybierz .
Wprowadź nazwę użytkownika w polu Role Name (np.
odoo).Otwórz zakładkę Definition, wprowadź hasło (np.
odoo) i kliknij Save.Otwórz zakładkę Privileges i przełącz Can login? na
Yesoraz Create database? naYes.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Informacja
Ponieważ użytkownik PostgreSQL ma taką samą nazwę jak login Unix, możliwe jest połączenie z bazą danych bez hasła.
Informacja
Jeśli chcesz korzystać z funkcji AI Odoo, wymagane jest rozszerzenie PostgreSQL pg-vector.
Należy pamiętać, że pg-vector jest dostępny tylko dla PostgreSQL w wersji 15 i nowszych.
Przejdź do folderu tymczasowego
$ cd /tmp
Sklonuj repozytorium GitHub
pg-vector:$ git clone https://github.com/pgvector/pgvector.gitPrzejdź do katalogu:
$ cd pgvector
Skompiluj rozszerzenie:
$ makeZainstaluj rozszerzenie:
$ sudo make install
Jeśli napotkasz jakiekolwiek problemy podczas instalacji, sprawdź oficjalne uwagi dotyczące instalacji.
Przejdź do folderu tymczasowego
$ cd /tmp
Sklonuj repozytorium GitHub
pg-vector:$ git clone https://github.com/pgvector/pgvector.gitPrzejdź do katalogu:
$ cd pgvector
Skompiluj rozszerzenie:
$ makeZainstaluj rozszerzenie:
$ sudo make install
Jeśli napotkasz jakiekolwiek problemy podczas instalacji, sprawdź oficjalne uwagi dotyczące instalacji.
Przejdź do folderu tymczasowego
$ cd %TEMP%
Sklonuj repozytorium GitHub
pg-vector:$ git clone https://github.com/pgvector/pgvector.gitPrzejdź do katalogu:
$ cd pgvector
Upewnij się, że obsługa C++ w Visual Studio jest zainstalowana i uruchom
x64 Native Tools Command Prompt for VS [wersja]jako administrator.Ustaw zmienną środowiskową
PGROOT:$ set "PGROOT=C:\Program Files\PostgreSQL\[Your PostgreSQL Version]"
Skompiluj rozszerzenie:
$ nmake /F Makefile.winZainstaluj rozszerzenie:
$ nmake /F Makefile.win install
Jeśli napotkasz jakiekolwiek problemy podczas instalacji, upewnij się, że sprawdzisz oficjalne uwagi dotyczące instalacji.
Zależności¶
Używanie pakietów dystrybucyjnych jest preferowanym sposobem instalacji zależności. Alternatywnie można zainstalować zależności Pythona za pomocą pip.
Na Debianie/Ubuntu następujące polecenia powinny zainstalować wymagane pakiety:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh script will parse the debian/control file and install the found packages.
Ostrzeżenie
Używanie pip może prowadzić do problemów z bezpieczeństwem i uszkodzonych zależności; rób to tylko, jeśli wiesz, co robisz.
Ponieważ niektóre pakiety Pythona wymagają etapu kompilacji, potrzebują zainstalowanych bibliotek systemowych.
Na Debianie/Ubuntu następujące polecenie powinno zainstalować te wymagane biblioteki:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Zależności Odoo są wymienione w pliku requirements.txt znajdującym się w katalogu głównym Odoo Community.
Informacja
Pakiety Pythona w requirements.txt są oparte na ich stabilnej/LTS wersji Debiana/Ubuntu odpowiadającej dacie wydania Odoo. Na przykład dla Odoo 15.0 wersja pakietu python3-babel to 2.8.0 w Debianie Bullseye i 2.6.0 w Ubuntu Focal. Najniższa wersja jest następnie wybierana w requirements.txt.
Wskazówka
Może być wskazane, aby nie mieszać pakietów modułów Pythona między różnymi instancjami Odoo lub z systemem. Można jednak użyć virtualenv do tworzenia izolowanych środowisk Pythona.
Przejdź do ścieżki instalacji Odoo Community (CommunityPath) i uruchom pip na pliku wymagań, aby zainstalować wymagania dla bieżącego użytkownika.
$ cd /CommunityPath
$ pip install -r requirements.txt
Przed instalacją zależności pobierz i zainstaluj Build Tools for Visual Studio. Wybierz C++ build tools w zakładce Workloads i zainstaluj je po wyświetleniu monitu.
Zależności Odoo są wymienione w pliku requirements.txt znajdującym się w katalogu głównym Odoo Community.
Wskazówka
Może być wskazane, aby nie mieszać pakietów modułów Pythona między różnymi instancjami Odoo lub z systemem. Można jednak użyć virtualenv do tworzenia izolowanych środowisk Pythona.
Przejdź do ścieżki instalacji Odoo Community (CommunityPath) i uruchom pip na pliku wymagań w terminalu z uprawnieniami administratora:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Zależności Odoo są wymienione w pliku requirements.txt znajdującym się w katalogu głównym Odoo Community.
Wskazówka
Może być wskazane, aby nie mieszać pakietów modułów Pythona między różnymi instancjami Odoo lub z systemem. Można jednak użyć virtualenv do tworzenia izolowanych środowisk Pythona.
Przejdź do ścieżki instalacji Odoo Community (CommunityPath) i uruchom pip na pliku wymagań:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Informacja
W przypadku języków używających interfejsu od prawej do lewej (takich jak arabski lub hebrajski) wymagany jest pakiet rtlcss.
Pobierz i zainstaluj nodejs oraz npm za pomocą menedżera pakietów.
Zainstaluj
rtlcss:$ sudo npm install -g rtlcss
Pobierz i zainstaluj nodejs.
Zainstaluj
rtlcss:C:\> npm install -g rtlcssEdytuj zmienną środowiskową systemu
PATH, aby dodać folder, w którym znajduje sięrtlcss.cmd(zazwyczaj:C:\Users\<użytkownik>\AppData\Roaming\npm\).
Ostrzeżenie
wkhtmltopdf nie jest instalowany przez pip i musi być zainstalowany ręcznie w wersji 0.12.6, aby obsługiwał nagłówki i stopki. Sprawdź wkhtmltopdf wiki, aby uzyskać więcej informacji na temat różnych wersji.
Uruchamianie Odoo¶
Po skonfigurowaniu wszystkich zależności Odoo można uruchomić, wykonując odoo-bin, interfejs wiersza poleceń serwera. Znajduje się on w katalogu głównym katalogu Odoo Community.
Aby skonfigurować serwer, należy określić argumenty wiersza poleceń lub plik konfiguracyjny.
Wskazówka
W przypadku edycji Enterprise dodaj ścieżkę do dodatków enterprise do argumentu addons-path. Należy pamiętać, że musi ona znajdować się przed innymi ścieżkami w addons-path, aby dodatki zostały poprawnie załadowane.
Typowe niezbędne konfiguracje to:
Użytkownik i hasło PostgreSQL.
Niestandardowe ścieżki dodatków poza domyślnymi do ładowania niestandardowych modułów.
Typowy sposób uruchomienia serwera wyglądałby następująco:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Gdzie CommunityPath to ścieżka instalacji Odoo Community, a mydb to nazwa bazy danych PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Gdzie CommunityPath to ścieżka instalacji Odoo Community, dbuser to login PostgreSQL, dbpassword to hasło PostgreSQL, a mydb to nazwa bazy danych PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Gdzie CommunityPath to ścieżka instalacji Odoo Community, a mydb to nazwa bazy danych PostgreSQL.
Po uruchomieniu serwera (wyświetlenie logu INFO odoo.modules.loading: Modules loaded.) otwórz http://localhost:8069 w przeglądarce internetowej i zaloguj się do bazy danych Odoo za pomocą podstawowego konta administratora: użyj admin jako adresu e-mail i ponownie admin jako hasła.
Wskazówka
Stamtąd twórz i zarządzaj nowymi użytkownikami.
Konto użytkownika używane do logowania się do interfejsu webowego Odoo różni się od argumentu CLI
--db_user.
Zobacz także