Installation av källa¶
Källan ”installation” handlar inte om att installera Odoo utan att köra det direkt från källan istället.
Att använda Odoo-källan kan vara bekvämare för modulutvecklare eftersom den är mer lättillgänglig än att använda paketerade installatörer.
Det gör start och stopp av Odoo mer flexibelt och tydligt än de tjänster som ställs in av de paketerade installatörerna. Det gör det också möjligt att åsidosätta inställningar med kommandoradsparametrar utan att behöva redigera en konfigurationsfil.
Slutligen ger det större kontroll över systemets inställningar och gör det lättare att hålla (och köra) flera versioner av Odoo sida vid sida.
Hämta källorna¶
Det finns två sätt att få tag på källkoden till Odoo: som ett ZIP arkiv eller via Git.
Arkiv¶
Gemenskapsutgåva:
Nätternas server <https://nightly.odoo.com>`_
Enterprise-utgåva:
Git¶
Observera
Det krävs att Git är installerat, och det rekommenderas att du har grundläggande kunskaper om Git-kommandon för att kunna fortsätta.
För att klona ett Git-arkiv väljer du mellan kloning med HTTPS eller SSH. I de flesta fall är HTTPS det bästa alternativet. Välj dock SSH för att bidra till Odoo-källkod eller när du följer Getting Started utvecklarhandledning.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Observera
Enterprise git repository innehåller inte den fullständiga Odoo-källkoden. Det är bara en samling av extra tillägg. Den huvudsakliga serverkoden finns i Community-versionen. Att köra Enterprise-versionen innebär att köra servern från Community-versionen med alternativet addons-path
inställt på mappen med Enterprise-versionen. Det är nödvändigt att klona både Community- och Enterprise-repositorierna för att ha en fungerande Odoo Enterprise-installation.
Förbereda¶
Python¶
Odoo kräver Python 3.7 eller senare för att fungera.
Använd en pakethanterare för att ladda ner och installera Python 3 om det behövs.
Ladda ner den senaste versionen av Python 3 och installera den.
Under installationen markerar du Add Python 3 to PATH, klickar sedan på Customize Installation och kontrollerar att pip är markerat.
Observera
Om Python 3 redan är installerat, se till att versionen är 3.7 eller högre, eftersom tidigare versioner inte är kompatibla med Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Kontrollera att pip också är installerat för den här versionen.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo använder PostgreSQL som sitt databashanteringssystem.
Använd en pakethanterare för att ladda ner och installera PostgreSQL (stödda versioner: 12.0 eller senare). Det kan uppnås genom att utföra följande:
$ sudo apt install postgresql postgresql-client
Ladda ner PostgreSQL (versioner som stöds: 12.0 eller senare) och installera den.
Använd Postgres.app för att ladda ner och installera PostgreSQL (version som stöds: 12.0 eller senare).
Tips
För att göra kommandoradsverktygen som ingår i Postgres.app tillgängliga, se till att ställa in variabeln $PATH
genom att följa instruktionerna Postgres.app CLI tools.
Som standard är den enda användaren postgres
. Eftersom Odoo förbjuder anslutning som postgres
, skapa en ny PostgreSQL-användare.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Observera
Eftersom PostgreSQL-användaren har samma namn som Unix-inloggningen är det möjligt att ansluta till databasen utan lösenord.
Lägg till PostgreSQLs
bin
-katalog (som standard:C:\Program Files\PostgreSQL\<version>\bin
) iPATH
.Skapa en postgres-användare med ett lösenord med hjälp av guiden pg admin:
Öppen pgAdmin.
Dubbelklicka på servern för att skapa en anslutning.
Välj
.Ange användarnamnet i fältet Rollnamn (t.ex.
odoo
).Öppna fliken Definition, ange ett lösenord (t.ex.
odoo
) och klicka på Spara.Öppna fliken Privilegier och ändra Kan logga in? till
Ja
och Kreera databas? tillJa
.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Observera
Eftersom PostgreSQL-användaren har samma namn som Unix-inloggningen är det möjligt att ansluta till databasen utan lösenord.
Beroenden¶
Att använda distributionspaket är det bästa sättet att installera beroenden. Alternativt kan du installera Python-beroenden med pip.
På Debian/Ubuntu bör följande kommandon installera de paket som krävs:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh
script will parse the debian/control file and install the found packages.
Varning
Att använda pip kan leda till säkerhetsproblem och trasiga beroenden; gör det bara om du vet vad du gör.
Eftersom vissa av Python-paketen behöver ett kompileringssteg, kräver de att systembibliotek installeras.
På Debian/Ubuntu installeras de nödvändiga biblioteken med följande kommando:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo-beroenden listas i filen requirements.txt
som finns i roten av Odoo Community-katalogen.
Observera
Python-paketen i requirements.txt
är baserade på deras motsvarande version i stable/LTS Debian/Ubuntu vid tidpunkten för Odoo-utgåvan. För Odoo 15.0 är t.ex. paketversionen av python3-babel
2.8.0 i Debian Bullseye och 2.6.0 i Ubuntu Focal. Den lägsta versionen väljs sedan i requirements.txt
.
Tips
Det kan vara att föredra att inte blanda Python-modulpaket mellan olika instanser av Odoo eller med systemet. Det är dock möjligt att använda virtualenv för att skapa isolerade Python-miljöer.
Navigera till sökvägen för Odoo Community-installationen (CommunityPath
) och kör pip på kravfilen för att installera kraven för den aktuella användaren.
$ cd /CommunityPath
$ pip install -r requirements.txt
Innan du installerar beroendena ska du hämta och installera Build Tools for Visual Studio. Välj C++ build tools på fliken Workloads och installera dem när du uppmanas till det.
Odoo-beroenden listas i filen requirements.txt
som finns i roten av Odoo Community-katalogen.
Tips
Det kan vara att föredra att inte blanda Python-modulpaket mellan olika instanser av Odoo eller med systemet. Det är dock möjligt att använda virtualenv för att skapa isolerade Python-miljöer.
Navigera till sökvägen för Odoo Community-installationen (CommunityPath
) och kör pip på kravfilen i en terminal med administratörsbehörighet:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo-beroenden listas i filen requirements.txt
som finns i roten av Odoo Community-katalogen.
Tips
Det kan vara att föredra att inte blanda Python-modulpaket mellan olika instanser av Odoo eller med systemet. Det är dock möjligt att använda virtualenv för att skapa isolerade Python-miljöer.
Navigera till sökvägen för Odoo Community-installationen (CommunityPath
) och kör pip på kravfilen:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Observera
För språk som använder ett höger-till-vänster-gränssnitt (t.ex. arabiska eller hebreiska) krävs paketet rtlcss
.
Hämta och installera nodejs och npm med en pakethanterare.
Installera
rtlcss
:$ sudo npm install -g rtlcss
Ladda ner och installera nodejs.
Installera
rtlcss
:C:\> npm install -g rtlcss
Lägg till mappen där
rtlcss.cmd
finns i systemmiljöns variabelPATH
(vanligtvis:C:\Users\<user>\AppData\Roaming\npm\
).
Varning
wkhtmltopdf
installeras inte via pip och måste installeras manuellt i version 0.12.6 för att den ska stödja sidhuvud och sidfot. Kolla in wkhtmltopdf wiki för mer information om de olika versionerna.
Drift av Odoo¶
När alla beroenden har konfigurerats kan Odoo startas genom att köra odoo-bin
, serverns kommandoradsgränssnitt. Det finns i roten av Odoo Community-katalogen.
Konfigurera servern genom att antingen ange kommandoradsargument eller en konfigurationsfil.
Tips
För Enterprise edition, lägg till sökvägen till enterprise
-tilläggen i addons-path
-argumentet. Observera att det måste komma före de andra sökvägarna i addons-path
för att tilläggen ska laddas korrekt.
Vanliga nödvändiga konfigurationer är:
PostgreSQL-användare och lösenord.
Anpassade addon-sökvägar utöver standardinställningarna för att ladda anpassade moduler.
Ett typiskt sätt att köra servern skulle vara:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Där CommunityPath
är sökvägen till Odoo Community-installationen och mydb
är namnet på PostgreSQL-databasen.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Där CommunityPath
är sökvägen till Odoo Community-installationen, dbuser
är PostgreSQL-inloggningen, dbpassword
är PostgreSQL-lösenordet och mydb
är namnet på PostgreSQL-databasen.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Där CommunityPath
är sökvägen till Odoo Community-installationen och mydb
är namnet på PostgreSQL-databasen.
När servern har startat (INFO-loggen odoo.modules.loading: Modules loaded.
skrivs ut), öppna http://localhost:8069 i en webbläsare och logga in i Odoo-databasen med basadministratörskontot: använd admin
som e-post och, återigen, admin
som lösenord.
Tips