Jak zainstalować Odoo na Ubuntu? Kompletny przewodnik krok po kroku

30 maja 2026 przez

Odoo to potężny system ERP typu open-source, który może zrewolucjonizować sposób zarządzania Twoją firmą. Instalacja Odoo na Ubuntu to proces, który może wydawać się skomplikowany, ale dzięki naszemu przewodnikowi przeprowadzisz go sprawnie i bezpiecznie. W tym artykule pokażemy Ci, jak krok po kroku zainstalować i skonfigurować Odoo na serwerze Ubuntu.

Przygotowanie systemu Ubuntu do instalacji Odoo

Przed rozpoczęciem instalacji Odoo na Ubuntu należy odpowiednio przygotować system operacyjny. Zalecamy użycie Ubuntu 20.04 LTS, 22.04 LTS lub nowszej wersji LTS (Long Term Support). Pierwszym krokiem jest zaktualizowanie wszystkich pakietów systemowych do najnowszych wersji.

Aktualizacja systemu

Zaloguj się do swojego serwera Ubuntu i wykonaj następujące komendy:

sudo apt update
sudo apt upgrade -y

Te polecenia zapewnią, że Twój system działa na najnowszych wersjach oprogramowania, co jest kluczowe dla bezpieczeństwa i stabilności.

Instalacja i konfiguracja PostgreSQL

Odoo wykorzystuje PostgreSQL jako system zarządzania bazą danych. Jest to kluczowy element, który musi być prawidłowo skonfigurowany przed instalacją samego Odoo. PostgreSQL powinien być zainstalowany jako pierwszy, ponieważ Odoo będzie od niego zależne.

Instalacja PostgreSQL

Zainstaluj PostgreSQL wykonując:

sudo apt install postgresql postgresql-client -y

Tworzenie użytkownika bazy danych

Utwórz dedykowanego użytkownika PostgreSQL dla Odoo:

sudo su - postgres -c "createuser -s odoo"

Ten użytkownik będzie miał uprawnienia superużytkownika, co jest niezbędne do zarządzania bazami danych przez Odoo. Dla środowisk produkcyjnych możesz dodatkowo ustawić hasło dla użytkownika bazy danych:

sudo su - postgres
psql
ALTER USER odoo WITH PASSWORD 'silne_haslo_bazy_danych';
\q
exit

Instalacja wymaganych zależności systemowych

Odoo wymaga szeregu pakietów i bibliotek do prawidłowego funkcjonowania. Zainstaluj niezbędne zależności przy użyciu następującej komendy:

sudo apt install -y python3-pip python3-dev python3-venv libxml2-dev libxslt1-dev zlib1g-dev libsasl2-dev libldap2-dev build-essential libssl-dev libffi-dev libmysqlclient-dev libjpeg-dev libpq-dev libjpeg8-dev liblcms2-dev libblas-dev libatlas-base-dev npm nodejs git

Instalacja wkhtmltopdf

Odoo wymaga wkhtmltopdf do generowania raportów PDF. Pobierz i zainstaluj zalecaną wersję:

sudo apt install wkhtmltopdf -y

Dla lepszej jakości raportów PDF możesz zainstalować wersję z oficjalnej strony wkhtmltopdf z włączonym patched qt:

cd /tmp
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb
sudo apt install -y ./wkhtmltox_0.12.6.1-2.jammy_amd64.deb

Instalacja Odoo na Ubuntu

Teraz przechodzimy do właściwej instalacji systemu Odoo. Istnieje kilka metod instalacji, ale przedstawimy najbardziej zalecaną metodę instalacji ze źródeł, która daje pełną kontrolę nad konfiguracją i aktualizacjami.

Tworzenie użytkownika systemowego dla Odoo

Ze względów bezpieczeństwa, Odoo powinno działać jako dedykowany użytkownik systemowy bez uprawnień logowania:

sudo adduser --system --home=/opt/odoo --group odoo

Pobieranie Odoo ze źródeł

Sklonuj oficjalne repozytorium Odoo z GitHub. W tym przykładzie instalujemy Odoo 17.0, ale możesz wybrać inną wersję zmieniając numer w parametrze --branch:

sudo git clone https://www.github.com/odoo/odoo --depth 1 --branch 17.0 /opt/odoo/odoo17

Ustaw odpowiednie uprawnienia do katalogów:

sudo chown -R odoo:odoo /opt/odoo

Tworzenie środowiska wirtualnego Python

Utwórz wirtualne środowisko Python dla Odoo jako użytkownik odoo:

sudo su - odoo -s /bin/bash
cd /opt/odoo
python3 -m venv odoo-venv
exit

Zainstaluj wymagane pakiety Python korzystając ze środowiska wirtualnego:

sudo su - odoo -s /bin/bash
source /opt/odoo/odoo-venv/bin/activate
pip install --upgrade pip
pip install wheel
pip install -r /opt/odoo/odoo17/requirements.txt
deactivate
exit

Instalacja wszystkich zależności Python może zająć kilka minut. Upewnij się, że proces zakończył się bez błędów.

Tworzenie katalogów dla niestandardowych dodatków

Utwórz katalog dla własnych i zewnętrznych modułów Odoo:

sudo mkdir /opt/odoo/custom-addons
sudo chown odoo:odoo /opt/odoo/custom-addons

Konfiguracja Odoo

Po zainstalowaniu wszystkich niezbędnych komponentów, należy skonfigurować Odoo, aby działało poprawnie na Twoim serwerze Ubuntu.

Tworzenie pliku konfiguracyjnego

Utwórz katalog konfiguracyjny i plik konfiguracyjny:

sudo mkdir /etc/odoo
sudo nano /etc/odoo/odoo.conf

Podstawowa konfiguracja powinna zawierać następujące parametry:

[options]
admin_passwd = silnehasło123_ZMIEN_TO
db_host = False
db_port = False
db_user = odoo
db_password = False
addons_path = /opt/odoo/odoo17/addons,/opt/odoo/custom-addons
logfile = /var/log/odoo/odoo.log
log_level = info
xmlrpc_port = 8069
proxy_mode = True

Ważne: Koniecznie zmień wartość admin_passwd na silne, unikalne hasło. To hasło jest używane do tworzenia, usuwania i zarządzania bazami danych z poziomu interfejsu Odoo.

Jeśli ustawiłeś hasło dla użytkownika PostgreSQL, dodaj parametr:

db_password = twoje_haslo_postgresql

Ustaw odpowiednie uprawnienia do pliku konfiguracyjnego:

sudo chown odoo:odoo /etc/odoo/odoo.conf
sudo chmod 640 /etc/odoo/odoo.conf

Tworzenie pliku dziennika

Utwórz katalog dla plików dziennika i ustaw odpowiednie uprawnienia:

sudo mkdir /var/log/odoo
sudo chown odoo:odoo /var/log/odoo

Uruchomienie Odoo jako usługa systemowa

Aby Odoo uruchamiało się automatycznie po restarcie serwera i działało w tle, skonfiguruj je jako usługę systemd.

Tworzenie pliku usługi

Utwórz plik usługi systemd:

sudo nano /etc/systemd/system/odoo.service

Dodaj następującą konfigurację:

[Unit]
Description=Odoo ERP System
Documentation=https://www.odoo.com
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo
PermissionsStartOnly=true
User=odoo
Group=odoo
ExecStart=/opt/odoo/odoo-venv/bin/python3 /opt/odoo/odoo17/odoo-bin -c /etc/odoo/odoo.conf
StandardOutput=journal+console
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Uruchomienie usługi

Przeładuj demona systemd i uruchom usługę Odoo:

sudo systemctl daemon-reload
sudo systemctl start odoo
sudo systemctl enable odoo

Sprawdź status usługi, aby upewnić się, że działa poprawnie:

sudo systemctl status odoo

Możesz również sprawdzić logi w czasie rzeczywistym:

sudo journalctl -u odoo -f

Dostęp do Odoo przez przeglądarkę

Po pomyślnej instalacji i uruchomieniu usługi, Odoo powinno być dostępne w przeglądarce pod adresem:

http://adres_IP_serwera:8069

Przy pierwszym uruchomieniu zobaczysz ekran tworzenia nowej bazy danych. Wypełnij wymagane pola:

Master Password - hasło ustawione w pliku konfiguracyjnym (admin_passwd)
Database Name - nazwa Twojej bazy danych
Email - adres e-mail administratora
Password - hasło do konta administratora w Odoo
Language - wybierz język (Polish)
Country - wybierz kraj (Poland)

Po utworzeniu bazy danych zostaniesz automatycznie zalogowany do systemu.

Zabezpieczenie instalacji Odoo

Bezpieczeństwo Twojej instalacji Odoo na Ubuntu jest niezwykle ważne, szczególnie jeśli system będzie dostępny z internetu. Oto kluczowe kroki zabezpieczające.

Konfiguracja zapory sieciowej

Skonfiguruj UFW (Uncomplicated Firewall), aby zezwolić na połączenia tylko na wymaganych portach:

sudo ufw allow 22/tcp
sudo ufw allow 8069/tcp
sudo ufw enable

Jeśli będziesz używać Nginx jako reverse proxy, dodaj również:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Możesz wtedy zablokować bezpośredni dostęp do portu 8069 z zewnątrz i zezwolić tylko z localhost:

sudo ufw delete allow 8069/tcp

W pliku konfiguracyjnym Odoo zmień wtedy:

xmlrpc_interface = 127.0.0.1

Konfiguracja Nginx jako reverse proxy

Zaleca się używanie Nginx jako reverse proxy dla Odoo, co zwiększy bezpieczeństwo, wydajność i umożliwi używanie SSL/TLS. Zainstaluj Nginx:

sudo apt install nginx -y

Utwórz plik konfiguracyjny dla Odoo:

sudo nano /etc/nginx/sites-available/odoo

Dodaj podstawową konfigurację (zastąp twoja-domena.pl swoją domeną):

upstream odoo {
    server 127.0.0.1:8069;
}

upstream odoochat {
    server 127.0.0.1:8072;
}

server {
    listen 80;
    server_name twoja-domena.pl www.twoja-domena.pl;

    access_log /var/log/nginx/odoo-access.log;
    error_log /var/log/nginx/odoo-error.log;

    proxy_read_timeout 720s;
    proxy_connect_timeout 720s;
    proxy_send_timeout 720s;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;

    location / {
        proxy_redirect off;
        proxy_pass http://odoo;
    }

    location /longpolling {
        proxy_pass http://odoochat;
    }

    location ~* /web/static/ {
        proxy_cache_valid 200 90m;
        proxy_buffering on;
        expires 864000;
        proxy_pass http://odoo;
    }

    client_max_body_size 100M;
    gzip on;
    gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
}

Aktywuj konfigurację i zrestartuj Nginx:

sudo ln -s /etc/nginx/sites-available/odoo /etc/nginx/sites-enabled/odoo
sudo nginx -t
sudo systemctl restart nginx

Następnie zainstaluj certyfikat SSL używając Let's Encrypt:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d twoja-domena.pl -d www.twoja-domena.pl

Pierwsze kroki po instalacji

Po pomyślnej instalacji Odoo na Ubuntu, warto zapoznać się z podstawowymi funkcjami systemu. Jeśli chcesz dowiedzieć się więcej o instalacji Odoo w różnych środowiskach, sprawdź nasz artykuł Jak zainstalować Odoo krok po kroku.

Po zainstalowaniu systemu możesz rozpocząć konfigurację poszczególnych modułów. Zacznij od podstawowych funkcji, takich jak zarządzanie relacjami z klientami w Odoo CRM czy konfiguracja modułu sprzedaży.

Dla firm produkcyjnych szczególnie przydatny będzie moduł Odoo Manufacturing do zarządzania produkcją, a dla firm handlowych - kompleksowe zarządzanie magazynem.

Najczęściej zadawane pytania (FAQ)

Jakie są wymagania systemowe dla instalacji Odoo na Ubuntu?

Minimalne wymagania to Ubuntu 20.04 LTS lub nowszy (zalecane wersje LTS), minimum 2 GB RAM (zalecane 4 GB dla małych firm, 8 GB+ dla średnich i dużych), 40 GB przestrzeni dyskowej (więcej w zależności od ilości danych), PostgreSQL 12 lub nowszy oraz Python 3.8+. Dla większych instalacji z wieloma użytkownikami zaleca się znacznie więcej zasobów - 16 GB RAM i dwurdzeniowy procesor to rozsądne minimum dla 10-20 równoczesnych użytkowników.

Czy mogę zainstalować Odoo na Ubuntu bez wiedzy technicznej?

Instalacja Odoo na Ubuntu wymaga podstawowej znajomości linii komend Linux, administracji serwerem, zarządzania uprawnieniami oraz konfiguracji usług systemowych. Jeśli nie masz doświadczenia technicznego, zalecamy skorzystanie z pomocy profesjonalnego partnera Odoo, który przeprowadzi instalację i konfigurację zgodnie z najlepszymi praktykami bezpieczeństwa i wydajności. Alternatywnie możesz rozważyć Odoo.sh - oficjalną platformę chmurową Odoo.

Jak długo trwa instalacja Odoo na Ubuntu?

Sama instalacja Odoo na Ubuntu zgodnie z tym przewodnikiem zajmuje zazwyczaj od 45 minut do 2 godzin, w zależności od doświadczenia osoby instalującej, szybkości połączenia internetowego i specyfikacji serwera. Należy jednak pamiętać, że pełna konfiguracja systemu, instalacja i konfiguracja modułów, dostosowanie do potrzeb firmy, migracja danych i szkolenie użytkowników może zająć od kilku dni do kilku tygodni.

Jak zaktualizować Odoo do nowszej wersji?

Aktualizacja Odoo wymaga pobrania nowej wersji z repozytorium GitHub, aktualizacji zależności Python, wykonania kopii zapasowej bazy danych oraz uruchomienia procesu aktualizacji z parametrem -u all. Proces ten jest bardziej skomplikowany niż instalacja i zalecamy wykonanie go na środowisku testowym przed aktualizacją produkcji. Warto również skorzystać z pomocy partnera Odoo, szczególnie przy aktualizacjach większych wersji (np. z 16.0 do 17.0).

Czy mogę uruchomić wiele instancji Odoo na jednym serwerze?

Tak, możesz uruchomić wiele instancji Odoo na jednym serwerze Ubuntu. Każda instancja wymaga osobnego pliku konfiguracyjnego z innym portem, osobnego użytkownika systemowego (opcjonalnie) i osobnej usługi systemd. Możesz również używać tego samego serwera PostgreSQL, ale z oddzielnymi bazami danych. Nginx można skonfigurować do obsługi wielu domen wskazujących na różne instancje.

Podsumowanie

Instalacja Odoo na Ubuntu to proces wymagający uwagi i precyzji, ale dzięki naszemu przewodnikowi jesteś w stanie przeprowadzić go samodzielnie. Pamiętaj o najważniejszych krokach: instalacji PostgreSQL, utworzeniu dedykowanego użytkownika systemowego, poprawnej konfiguracji środowiska wirtualnego Python oraz zabezpieczeniu instalacji przez firewall i reverse proxy.

Kluczowe jest również regularne utrzymanie systemu - aktualizacje Ubuntu i Odoo, regularne kopie zapasowe baz danych (zarówno PostgreSQL jak i plików), monitorowanie wydajności serwera, logów systemowych oraz przestrzeni dyskowej. Zalecamy także konfigurację automatycznych backupów i testowanie procedur odzyskiwania danych.

Jeśli potrzebujesz profesjonalnego wsparcia przy instalacji, konfiguracji lub wdrożeniu Odoo w Twojej firmie, skontaktuj się z KK Innovations. Nasz zespół ekspertów posiada wieloletnie doświadczenie we wdrażaniu systemów Odoo i pomoże Ci w pełni wykorzystać potencjał tego potężnego narzędzia ERP. Oferujemy kompleksowe usługi - od instalacji, przez konfigurację i dostosowanie, po szkolenia i stałe wsparcie techniczne. Zapraszamy do kontaktu - razem znajdziemy optymalne rozwiązanie dla Twojego biznesu!

Czytaj następne

Jak zarządzać magazynem w Odoo - kompletny przewodnik