Mastodó

Si instal·laràs Odoo a Ubuntu Server, el més important és triar un mètode de desplegament que encara puguis mantenir d'aquí a dos anys. Docker, els paquets .deb oficials i la instal·lació des del codi font et permeten tenir Odoo operatiu en qüestió de minuts. La diferència es fa evident més endavant, quan cal actualitzar, afegir mòduls personalitzats o restaurar el servei després d'una fallada.

Per a una pime, prendre la decisió adequada redueix el temps d'inactivitat i els costos de suport, i evita haver de dependre d'una sola persona que sàpiga gestionar el servidor. Comparem els tres mètodes des de la perspectiva de l'administració diària i concloem amb una llista de comprovació per a la posada en marxa.

Punts clau:

  • Paquet Deb: la manera més ràpida d'obtenir la comunitat sense cap personalització.
  • Docker: el més reproduïble, però requereix volums persistents i tasques d'administració.
  • Codi font amb venv: control complet sobre mòduls personalitzats.
  • Odoo 19 i 20 estan instal·lats a Ubuntu 24.04 LTS.
  • Una còpia vàlida inclou la base de dades, l'emmagatzematge de fitxers, la configuració i els mòduls.
  • Escala segons els usuaris simultanis i les integracions, no segons el nombre total d'usuaris.

Quin mètode d'instal·lació s'adapta millor al vostre negoci?

Un equilibri entre un servidor compacte i blocs basats en el núvol: una metàfora per triar com instal·lar Odoo a Ubuntu Server.

El paquet Docker és adequat per a una pime que utilitza Odoo Community amb molt poc desenvolupament intern. Docker és l'opció correcta quan vols entorns de prova i de producció idèntics, mentre que el codi font és la millor opció quan mantens mòduls personalitzats o requereixes l'edició Enterprise amb un control precís de les dependències. Tots tres mètodes funcionen en producció si es gestionen correctament.

Per prendre una decisió, compara els tres desplegaments segons tres criteris: personalització, manteniment i recuperació. El primer mesura la facilitat d'afegir mòduls i biblioteques de Python. El segon indica la quantitat de feina que requereix cada actualització. El tercer mesura el temps que es necessita per reconstruir el servei en un altre servidor.

Paquets de deb oficials

Odoo S.A. publica un repositori a nightly.odoo.com que permet instal·lar l'edició Community fent servir `apt-get install odoo` i mantenir-la actualitzada amb `apt-get upgrade`. El paquet crea l'usuari de servei, la unitat systemd i el fitxer `/etc/odoo/odoo.conf`, i declara les dependències de Python com a paquets del sistema.

És el mètode que implica gestionar el menor nombre de components. El inconvenient sorgeix amb els mòduls personalitzats: si un mòdul requereix una llibreria de Python que Ubuntu no inclou en els seus paquets, o bé requereix una versió diferent, acabes barrejant pip amb apt. Aquesta barreja provoca errors durant les actualitzacions. Enterprise no es troba al repositori públic; es descarrega des de la pàgina de descàrregues d'Odoo amb una subscripció activa.

Docker i Docker Compose

Amb Docker Compose, defineixes Odoo i PostgreSQL en un únic fitxer `docker-compose.yml`, i aquest mateix fitxer et permet configurar els entorns de prova, preproducció i producció. La imatge fixa les versions de Python i wkhtmltopdf, cosa que evita qualsevol sorpresa amb les dependències del sistema operatiu.

Amb Docker, encara has de gestionar el servidor. Les dades d'Odoo s'emmagatzemen en volums, i si un contenidor es recrea sense ells, l'emmagatzematge de fitxers es perd. A més, continues sent responsable de les actualitzacions d'Ubuntu, del tallafocs, dels registres i de les còpies de seguretat. Docker és l'opció més reproduïble, tot i que no la més senzilla.

Instal·lació des del codi font

Clona la branca de llançament (per exemple, `19.0`) des de GitHub i crea un entorn virtual de Python. Instal·la les dependències de `requirements.txt` dins del venv i escriu tu mateix el fitxer de unitat de systemd. A Ubuntu 24.04, utilitzar un entorn virtual és pràcticament obligatori, ja que el sistema bloqueja les instal·lacions amb pip fora d'un venv.

Aquest mètode et dona un control complet. Pots especificar cada dependència, afegir directoris de mòduls per a Enterprise i els teus propis desenvolupaments, i depurar mentre veus el codi. A canvi, has de gestionar cada actualització tu mateix amb `git pull` i executar les proves pertinents, sense que un gestor de paquets t'avisi.

Versions compatibles d'Odoo, Ubuntu i PostgreSQL

Miniatura de YouTubeIcona de YouTube

La compatibilitat es prova per a la combinació específica d'Odoo, Ubuntu LTS i les versions de PostgreSQL i les seves dependències, no per a cada component de manera individual. Per a un nou desplegament el novembre de 2026, utilitzeu Ubuntu 24.04 LTS amb Odoo 19 o Odoo 20, PostgreSQL 14 o posterior i Python 3.12, que és la versió inclosa a Ubuntu 24.04.

Odoo 20 es va presentar a l'Odoo Experience 2026, celebrat a Brussel·les del 24 al 26 de setembre de 2026. Està basat en Python 3.12 i el procés d'instal·lació és molt similar al d'Odoo 19. Si el vostre soci o els mòduls de tercers que utilitzeu encara no estan preparats per a la versió 20, Odoo 19 en Ubuntu 24.04 és l'opció més assenyada.

On tendeixen a sorgir incompatibilitats

L'exemple més comú és wkhtmltopdf, l'eina que genera PDF de factures i pressupostos. A Ubuntu 24.04, el paquet del repositori no inclou el suport per a Qt amb el pegat que requereix Odoo. Per tant, és aconsellable instal·lar la versió 0.12.6.1-2, compilada per a Jammy (22.04). Sense aquesta, els PDF es generen sense capçaleres ni peu de pàgina.

Un altre problema potencial són les versions antigues. Instal·lar Odoo 16 o 17 en Ubuntu 24.04 pot causar incompatibilitats entre Python 3.12 i certes biblioteques les versions de les quals s'especifiquen a `requirements.txt`. Si estàs treballant amb una versió més antiga, Docker és la manera més neta d'aïllar-la mentre planifiquis la migració.

Actualitzacions i migracions

Actualitzar dins de la mateixa versió major – per exemple, aplicar pegats per a la versió 19.0 – és una operació rutinària. Migració d'Odoo 17 a 19 Canvia l'estructura de la base de dades i implica que els mòduls personalitzats s'han d'adaptar. Requereix un procediment diferent, una còpia de prova i una validació funcional abans de fer cap canvi en l'entorn de producció.

Quanta capacitat de CPU, RAM i SSD necessita una pimea?

Per a un entorn de proves o un sol desenvolupador, 2 GB de RAM i 2 nuclis són suficients. Per a la producció en una petita empresa, prevegeu com a mínim 2 vCPU i 4 GB de RAM. Amb menys de 10 usuaris, una configuració generosa és de 4 nuclis, 8 GB de RAM i un SSD de 250 GB. Per a entre 10 i 50 usuaris, prevegeu entre 16 i 32 GB de RAM i 500 GB d'emmagatzematge SSD o més.

Els requisits mínims que s'indiquen en moltes guies (2 GB de RAM, 5 GB d'espai en disc, un processador de doble nucli a 1 GHz) són gairebé insuficients per posar en marxa Odoo. Un servidor d'aquestes característiques pot suportar una demostració, però es veu desbordat tan bon punt ha de generar el seu primer informe comptable complex.

Quines variables són realment les que manen?

La mida depèn principalment de quatre factors:

  • Usuaris simultanis, no usuaris registrats.
  • Mòduls actius, com ara Inventari, Fabricació o Comptabilitat.
  • Tàsces programades (cron), com ara conciliacions o enviaments massius de correu electrònic.
  • Integracions d'API, com ara una botiga en línia, un sistema TPV o una plataforma de comerç electrònic.

Una empresa amb 40 usuaris al seu sistema ERP i 8 usuaris connectats simultàniament consumeix menys recursos que una altra amb 15 usuaris i una botiga en línia que sincronitza els nivells d'estoc cada minut. Mesura el nombre d'usuaris simultanis en hores punta abans de comprar maquinari.

Una estimació aproximada del nombre de treballadors

Odoo en producció utilitza el mode multiprocessos. Una regla general és configurar 2 treballadors per nucli més 1, amb cada treballador gestionant al voltant de 6 usuaris simultanis. Amb 4 nuclis, això dona 9 treballadors, cosa que significa una capacitat teòrica d'uns 54 usuaris simultanis. Si cada worker consumeix una mitjana de 150 MB, els 9 workers sumen 1.350 MB. Afegeix-hi PostgreSQL i el sistema operatiu, deixant 8 GB de RAM com a memòria cau. Sempre és aconsellable utilitzar SSD: PostgreSQL és sensible a la latència del disc, i un disc dur mecànic es fa notar en cada consulta.

Instal·lació pas a pas des del codi font a Ubuntu 24.04

Diagrama de flux que mostra el procés d'instal·lació d'Odoo en un servidor Ubuntu: Ubuntu 24.04, codi font, dependències, base de dades i servei d'Odoo.

Aquest mètode funciona tant per a les edicions Community com Enterprise i constitueix la base per entendre qualsevol altre mètode. Requereix uns 30–45 minuts en un servidor net. Estem utilitzant Odoo 19 com a exemple; per a la versió 20, només cal canviar la branca.

  1. Actualitza el sistema amb `sudo apt update && sudo apt upgrade -y` i instal·la les dependències de compilació: `git`, `python3-venv`, `python3-dev`, `build-essential`, `libpq-dev`, `libxml2-dev`, `libxslt1-dev`, `libldap2-dev`, `libsasl2-dev` i `libjpeg-dev`.
  2. Instal·la PostgreSQL amb `sudo apt install -y postgresql` i crea el rol: `sudo -u postgres createuser -s odoo19`.
  3. Crea un usuari de servei sense privilegis: `sudo useradd -m -d /opt/odoo19 -U -r -s /bin/bash odoo19`.
  4. Amb aquest nom d'usuari, clona només la branca necessària: `git clone https://www.github.com/odoo/odoo --depth 1 --branch 19.0 /opt/odoo19/odoo`.
  5. Crea l'entorn virtual amb `python3 -m venv odoo-venv`, activa'l i executa `pip install --upgrade pip wheel`, i després `pip install -r /opt/odoo19/odoo/requirements.txt`.
  6. Instal·la wkhtmltopdf 0.12.6.1-2 en la teva compilació de Jammy amb `sudo apt install ./wkhtmltox_0.12.6.1-2.jammy_amd64.deb`.
  7. Crea `/etc/odoo19.conf` amb `admin_passwd`, `db_user = odoo19`, `addons_path`, `logfile = /var/log/odoo/odoo19.log` i `proxy_mode = True`. Restricciona els seus permisos amb `chmod 640` i estableix l'usuari del servei com a propietari.
  8. Crea una unitat systemd que executi `odoo-bin` fent servir el Python del venv i el fitxer de configuració, i activa-la amb `systemctl enable --now`.
  9. Obreu `http://IP-del-servidor:8069` i creeu la vostra primera base de dades amb la contrasenya mestra.

On instal·lar Enterprise i els mòduls personalitzats

Mantingueu tres carpetes separades per al nucli d'Odoo, els mòduls Enterprise i els vostres mòduls personalitzats; per a aquests dos últims, podríeu utilitzar, per exemple, `/opt/odoo19/enterprise` i `/opt/odoo19/custom-addons`. Afegiu-los a `addons_path`, amb Enterprise llistat abans del nucli. D'aquesta manera, canviar de Community a Enterprise simplement implica copiar la carpeta, reiniciar el servidor i instal·lar `web_enterprise`.

Les dependències de Python per als mòduls personalitzats s'instal·len dins del mateix venv. Documenteu-les en un fitxer `requirements.txt` al repositori del mòdul. Sense aquest fitxer, reconstruir el servidor es converteix en una caça d'errors d'importació.

L'alternativa amb Docker Compose

Amb Docker, pots saltar els passos 1 a 6. Defineixes dos serveis: `db`, utilitzant la imatge oficial de PostgreSQL, i `web`, utilitzant la imatge oficial d'Odoo i l'etiqueta de versió exacta (`odoo:19`, mai `latest`). Munteu tres volums: les dades de PostgreSQL, `/var/lib/odoo` per a l'emmagatzematge de fitxers i una carpeta al servidor host a `/mnt/extra-addons` per als mòduls. El fitxer de configuració es munta a `/etc/odoo`.

Per actualitzar mantenint les dades i els mòduls, seguiu aquesta seqüència: feu una còpia de seguretat, executeu `docker compose pull` i `docker compose up -d`. A continuació, executeu l'actualització del mòdul amb l'opció `-u` a la base de dades. El volums anomenats Es conserven quan es recrea el contenidor; el que mai no has de fer és executar `docker compose down -v`, perquè aquesta opció elimina els volums.

Domini, proxy invers i HTTPS

Miniatura de YouTubeIcona de YouTube

Odoo no s'ha d'exposar directament al port 8069. Col·loqueu un proxy invers (Nginx o Caddy) davant seu per rebre el trànsit al port 443, gestionar la connexió TLS amb un certificat de Let's Encrypt i reenviar les sol·licituds a Odoo a localhost. En primer lloc, apunta el registre A del domini – per exemple, `erp.tuempresa.cat` – a l'adreça IP pública del servidor.

Caddy obté i renova el certificat automàticament mitjançant un bloc de tres línies. Amb Nginx, utilitzes Certbot, que configura la renovació amb un temporitzador de systemd. Ambdós mètodes funcionen; Caddy requereix menys configuració, mentre que Nginx ofereix un major control sobre la memòria cau i els límits.

Configuracions sovint passades per alt

A la configuració d'Odoo, activa `proxy_mode = True` perquè registri l'adreça IP real del client i generi URL amb HTTPS. En mode multiprocessos, el xat, les notificacions en directe i Discuss utilitzen un port separat (`gevent_port`, 8072 per defecte). El proxy ha d'enviar `/websocket` a aquest port. Si no ho fa, les notificacions en temps real deixaran de funcionar sense mostrar cap error evident.

També hauríeu d'ajustar la mida màxima de les sol·licituds de proxy, per exemple `client_max_body_size 100m` a Nginx. Amb el valor per defecte d'1 MB, les importacions grans i els fitxers adjunts fallaran.

Què cal canviar en passar de les proves a la producció

Equipament de producció d'Odoo juntament amb un bastidor Ubuntu, que inclou un servidor, emmagatzematge, UPS i cables; instal·lació d'Odoo en un servidor Ubuntu.

En un entorn de proves, la velocitat és primordial; en producció, és vital que ningú no perdi dades ni accés. Abans de concedir l'accés al personal, comproveu aquesta llista:

  1. Treballadors configurats (més de 0) i límits de memòria `limit_memory_soft` i `limit_memory_hard` definits.
  2. `list_db = False` per amagar el gestor de bases de dades, i una contrasenya llarga i única `admin_passwd`.
  3. Odoo només escolta en localhost (`http_interface = 127.0.0.1`), amb accés exclusivament a través del proxy.
  4. Un usuari de servei sense shell d'administrador, que només és propietari de les seves pròpies carpetes, i PostgreSQL sense accés a la xarxa.
  5. Firewall UFW amb només els ports 22, 80 i 443 oberts, i SSH amb autenticació per clau.
  6. Copies de seguretat automàtiques i xifrades emmagatzemades fora del servidor, amb un procés de restauració provat.
  7. Rotació de registres i monitoratge del disc, de la memòria i del servei.

Què hauria d'incloure una còpia de seguretat

Un dump de PostgreSQL per si sol no és suficient. Una còpia de seguretat d'Odoo que permet restaurar el servei inclou la base de dades amb `pg_dump`, l'emmagatzematge de fitxers de la mateixa data (adjunts, imatges i documents), el fitxer de configuració i el codi exacte dels mòduls personalitzats i Enterprise. Si la base de dades i l'emmagatzematge de fitxers no són coherents, restauraràs registres que fan referència a adjunts que no existeixen.

Per comprovar-ho, restaura la còpia de seguretat en un servidor de proves almenys un cop cada trimestre i mesura quant de temps triga. Aquest temps és el teu temps de recuperació real, independentment del que diu sobre el paper.

Recuperació depenent del mètode escollit

Amb Docker, la recuperació implica copiar el fitxer `docker-compose.yml`, restaurar els volums i iniciar el sistema. Amb el paquet deb, reinstal·les amb apt i restaures les dades. Si utilitzes el codi font, també hauràs de tornar a construir el venv. Per això és una bona idea commitjar la configuració i la unitat systemd a Git juntament amb els mòduls.

Proveu el desplegament abans de migrar.

Si encara no n'estàs segur, instal·la Odoo en un servidor de proves amb el mètode que hagis triat i fes una instal·lació completa i nova. Mesura quant de temps triga i pren nota de cada pas manual. Si el procés depèn de la memòria d'una sola persona, el desplegament encara no està a punt per a producció. Si preferiu rebre ajuda amb el vostre desplegament actual, Synergia ofereix els seus serveis a Barcelona Implementació, allotjament i suport d'Odoo utilitzant Docker i PostgreSQL.

Preguntes freqüents

Què canvia quan instal·les Odoo Community o Enterprise?

Community és programari lliure amb llicència LGPLv3 i es pot instal·lar des del repositori públic o des de GitHub. Enterprise afegeix aplicacions com Studio i l'aplicació mòbil, i requereix una subscripció de pagament. Tècnicament, és una carpeta addicional de mòduls a `addons_path`.

Puc instal·lar Odoo a Ubuntu 22.04 en lloc de 24.04?

Sí, per a Odoo 17 o versions anteriors, que es van dissenyar sobre aquesta base. Per a Odoo 19 o 20, utilitzeu Ubuntu 24.04 LTS, ja que inclou Python 3.12 i tindrà suport durant més temps.

Docker afecta el rendiment d'Odoo?

No en un grau significatiu en un servidor Linux, perquè els contenidors comparteixen el nucli del sistema amfitrió. El que sí que afecta el rendiment, però, és l'emmagatzematge: col·loqueu els volums de PostgreSQL en un SSD local i eviteu les unitats de xarxa lentes.

Amb quina freqüència s'hauria d'actualitzar una instal·lació d'Odoo?

Aplica els pegats de la teva versió major un cop al mes, sempre després de fer una còpia de seguretat i dur a terme una prova preproductiva. Planifica la migració a una nova versió major com un projecte independent, incloent-hi proves funcionals i adaptació de mòduls.